Novell Storage Manager 3.1.1 for eDirectory Installation Guide 


Installation Guide 
Novell Storage Manager 3.1.1 for eDirectory 


October 17, 2013 


Novell. 


eToz sequiajdas gz (ua) sÁsoop 


Legal Notices 


Condrey Corporation makes no representations or warranties with respect to the contents or use of this documentation, and 
specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, 
Condrey Corporation reserves the right to revise this publication and to make changes to its content, at any time, without 
obligation to notify any person or entity of such revisions or changes. 


Further, Condrey Corporation makes no representations or warranties with respect to any software, and specifically disclaims 
any express or implied warranties of merchantability or fitness for any particular purpose. Further, Condrey Corporation 
reserves the right to make changes to any and all parts of the software at any time, without obligation to notify any person or 
entity of such revisions or changes. See the Software EULA for full license and warranty information with regard to the 
Software. 


Any products or technical information provided under this Agreement may be subject to U.S. export controls and the trade 
laws of other countries. You agree to comply with all export control regulations and to obtain any required licenses or 
classification to export, re-export, or import deliverables. You agree not to export or re-export to entities on the current U.S. 
export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export laws. You agree to not use 
deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. Condrey Corporation assumes no 
responsibility for your failure to obtain any necessary export approvals. 


Copyright © 2012 Condrey Corporation. All Rights Reserved. 


No part of this publication may be reproduced, photocopied, or transmitted in any fashion with out the express written 
consent of the publisher. 


Condrey Corporation 

125 The Parkway, Suite 500 
Greenville, SC 29615 
U.S.A. 
www.condreycorp.com 


Novell Trademarks 


For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/company/legal/trademarks/ 
tmlist.html). 


Third-Party Materials 


All third-party trademarks are the property of their respective owners. 


eToz sequiajdas gz (ua) sÁsoop 


Contents 


About This Guide 5 

1 Prerequisites 7 
1.1 Preparing the Files for Installation... ......0..00 000 ccc ete 7 
1.2 Determining Your Installation Method... -- 0000 cee eee 7 
1.2.1 Direct from the File System .-- 0.000 ce eee 7 

1.2.2 HTML Installation Interface .. 6.0... sasaaa aaaea 8 

2 Licensing the Product 11 
21 LiCONSING:OVEIVISW sto atar A dd e ti oe ee ee TR 11 
2.2.  Obtaining:a License: Files 2.3.22 d 2.69 a a N ER aE NER e ee eee ee eee 12 
2.3 Updating a License File TTT 13 

3 Upgrading from Storage Manager 2.5x to 3.11 15 
3.1 Understanding the Upgrade Process... --- 0000 ee ee ete 15 
3.2 Migration Considerations ...........0.0.0..00 a RR a RRR eee 16 
3.2.1 Novell Storage Manager 2.0 Customers . 0 cece eee 16 

3.2.2 Novell Storage Manager 3.1.1 for eDirectory Components... aee 16 

3.2.3 NetWare: Suppr: c: 2 044 ook aed A ela awe ga Vine Se Ges eee ee 16 

3.2.4 Schema Management..............0 00 ce eee 17 

3.2.5 Policy, Catalog, and Pending Event Migration. . . - 0: cece 18 

3.3. Clearing Pending Events va rde g KTR E d RR e Ra RR a E ete 18 
3.4 Installing NSMAdmin 3.1.1 1.0.0... annaua anona 19 
3.5 Running the NSM Migration Utility... 2.20.00... 0002 eee 20 
3.6 Unloading Novell Storage Manager 2.5x Event Monitor Components...................++055 23 
3.7 Unloading Novell Storage Manager 2.5x Agent Components... eee eee 23 
3.8 Upgrading the NSM Engine _ .....o.o...ococcccono eee nee 24 
3.9 Configuring the NSM Engine.............. 0.60 cee ee 25 
3.10 Running the NSMAdmin 3.1.1 Setup Wizard. .........0 saaa esee 28 
3.11 Verifying Storage Resource ListS.......... 20.0000 cee ee 31 
3.12 Performing Manage Operations for Migrated Policies... -- 0000 cece eee 32 
3.13 Upgrading the Event Monitor ............ 0.00 ete 32 
3.14 Configuring the Event Monitor ...........0. 0.000: eee 33 
3:15; ‘Upgrading an: NSM AGENT gece sag tease teks ed te R beatles Gk tc ee Ghee Sees 36 
3.16 Configuring an NSM Agent... -- essas enesenn 37 
3.17 Authorizing the Event Monitor . 00000 tees 40 
3.18 Authorizing the NSM Agents . . - 00: eee eee 40 

4 Upgrading from Storage Manager 3.x to 3.1.1 41 
AV COVE e spoke rd uk ln tek acting) AAA AA ae ds ea eee ass 41 
4.2 Upgrading the NSM Engine... ---- + e eee 41 
4.3 Upgrading the Event Monitor... -- 0000 teen eee 42 
4.4 Upgrading the NSM Agent... ----- 06.00 c cette eee 43 
4.5.- Upgrading: NSMACmIN: > 2:30 R. a TE aE arah eras Aue! AGC Ae ead te oct lee Rd Gee 44 


Contents 


B Installing Novell Storage Manager 3.1.1 for eDirectory 


5.1 
5.2 
5.3 
5.4 
5.5 
5.6 
5.7 
5.8 
5.9 


Installing the NSM Engine -ssir 9 N T RATE T N ECR RE KAT dR tees 
Configuring the NSM Engine .............. 0 Z Roa A Z 0 E R tees 
Installing the Event Monitor . - - + 000 c cee tees 
Configuring the Event Monitor ............ 0.000 cette ee 
Installing an NSM Agent ...........0 d R E aL RE eee eee 
Configuring an NSM Agent o... 
Installing and Configuring NSMAdmin ............ 00000 eee 
Authorizing the Event Monitor . 0600 teens 
Authorizing the NSM Agents... - - +» 0c 


A NSM Engine Certificate Management 


A.1 
A.2 
A.3 


Upgrading Earlier Versions of Novell Storage Manager... --- 0c eee eee 
Creating a New Certificate... -- e tee ee 
Managing Existing Certificates... 1... 0.0.0... eee eee 


B Deploying Event Monitors and NSM Agents Remotely by Using the 


DeployAgents Tool 
Bil > (OVERVIEW A Bike A A Ses a a ee AA AAA A a 
B:2° “PrerequiSites it e ME eee ee Ae ee es A 
B:2.1, Windows .PowerShéll.. yi. eR R sda a ean eee eee vad ick ea ve hae es 
B.2.2 Windows Agents and Event Monitors ...... 00000 eee 
B.2.3 Linux Agents and Event Monitors... -- 000 c eee tee 
B.3 Copying the Component installées... -- 000 eee 
B.4 Creating the servernames.txt File 2.0.2.0... 000 eee eee 
B.4.1 | Manually Creating the servernames.txt File .... 0.0.0.0... 200 c eee 
B.4.2 Automatically Creating the servernames.txt File ............0. 0000 c eee eee 
B.5 Deploying the Linux RPMS......... 0.00. ccc ntti 
Bb. ‘External Utilities: e oa we a as a suk cea 's Weed avd ed ete ea 
B:5.2- Deployment: Specifics: oro ociosa fetes Sake es ee en ee A De ee 
B.5.3 Using DeployAgentsRPM.cmd ...- 000: tenes 
B.6 Deploying the Windows MSI or EXE FileS.... 2.2... 0.0 cee eee 
B:6.1. Deployment: Specifics’ +... cs-c0005 bowtie oped soba ada e tes 
B.6.2 Setting an Alternate Installation Path .........0.0 20.0.0... 2c cee tee 
B.6.3 Using DeployAgentsMSl.cmd ......o..ooocoocoocr ete 
B.6.4 Using DeployAgentsEXE.cmd............000 ccc teens 
C Documentation Updates 
CT. October T7203 eni boar A E baie a hn See eae ees 
G:2. 2 JUNE T2; 20 uta detente Sebel cents Rois a AS oes Sele cool athe As es 
Ia |- Pebruarys13 2013. 3 ity cl Sul ak, aie ee Manan bse ea tink ine E sed 
GA’. Januaty:18, 2013 3 en coe AA ge Aalto held dhs Sada ee sees 
Gib.) May LE LOL a Bek lke Hake eh i ea aed abd a ede A 
C:6 = + Pebruary'2): 2012.4. 10001o irradia bd tle La bebe be he kidd ened add wade! 
E February: 14-2011 2.06. DT ee ee a ey Shs 


Novell Storage Manager 3.1.1 for eDirectory Installation Guide 


About This Guide 


This installation guide is written to provide network administrators the conceptual and procedural 
information for installing and configuring Novell Storage Manager 3.1.1 for eDirectory. 


+ 


+ 


+ 


+ 


+ 


Chapter 1, “Prerequisites,” on page 7 

Chapter 2, “Licensing the Product,” on page 11 

Chapter 3, “Upgrading from Storage Manager 2.5x to 3.11,” on page 15 
Chapter 4, “Upgrading from Storage Manager 3.x to 3.1.1,” on page 41 

Chapter 5, “Installing Novell Storage Manager 3.1.1 for eDirectory,” on page 53 
Appendix A, “NSM Engine Certificate Management,” on page 73 


Appendix B, “Deploying Event Monitors and NSM Agents Remotely by Using the 
DeployAgents Tool,” on page 77 


Appendix C, “Documentation Updates,” on page 85 


Audience 


This guide is intended for network administrators who manage user and collaborative network 
storage resources. 


Feedback 


We want to hear your comments and suggestions about this guide and the other documentation 
included with this product. Please use the User Comment feature at the bottom of each page of the 
online documentation, or go to www.novell.com/documentation/feedback.html and enter your 
comments there. 


Documentation Updates 


For the most recent version of the Novell Storage Manager 3.1.1 for eDirectory Installation Guide, visit the 


Novell Storage Manager Web site (http://www.novell.com/documentation/storagemanager3/ 
index.html). 


Additional Documentation 


For additional Novell Storage Manager documentation, see the following guide at the Novell Storage 


Manager Documentation Web site (http://www.novell.com/documentation/storagemanager3): 


+ Novell Storage Manager 3.1.1 for eDirectory Administration Guide 


About This Guide 
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1,1 


1.2 


1.2.1 


Prerequisites 


This section provides procedures that you must do before installing the Novell Storage Manager 3.1.1 
for eDirectory components. 


+ Section 1.1, “Preparing the Files for Installation,” on page 7 


+ Section 1.2, “Determining Your Installation Method,” on page 7 


Preparing the Files for Installation 


Novell Storage Manager 3.1.1 is packaged as a single NSM_3_1_1.iso file. Before you can install the 
Novell Storage Manager 3.1.1 for eDirectory components, you must do one of the following: 


+ Mount the NSM_3_1_1.iso on the server where you are installing one of the Novell Storage 
Manager 3.1.1 components. 


+ Burn the NSM 3 1 1.isotoaCD or DVD 


Determining Your Installation Method 


+ Section 1.2.1, “Direct from the File System,” on page 7 
+ Section 1.2.2, “HTML Installation Interface,” on page 8 


You must install the following Novell Storage Manager 3.1.1 components: 


+ NSM Engine 
+ Event Monitor 
+ NSM Agents 
+ NSMAdmin 


The NSM Engine, Event Monitor, and NSM Agents can be installed by using any of the following 
methods: 


+ Section 1.2.1, “Direct from the File System,” on page 7 
¢ Section 1.2.2, “HTML Installation Interface,” on page 8 


Each of these methods is explained below. 


Direct from the File System 


Network administrators comfortable with running RPMs through a terminal session might prefer 
this method. 


+ SLES10\i586 and SLES11\i586 contain the installation RPMs for 32-bit processor servers 
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1.2.2 


+ SLES10\x86_64 and SLES11\x86_64 contain the installation RPMs for 64-bit processor servers. 


x86_64 - File Browser 


S 0 E 


Reload Home Computer 


El | 4 | OLERE | suests| la. 
ees = = = 


B root 


< 
< 
sm 


novell-storagemanager- novell-storagemanager- novell-storagemanager- 
E desktop agent-3.1.1-17.x86_64.pm  engine-3.1.1-42.xB6_64.rpm event-3.1.1-5.x86_64.pm 
E File System 
[Ca] Network Servers 
Floppy Drive 
(@)nsm_3_1.1 


3 items, Free space: 0 bytes 


HTML Installation Interface 


Novell Storage Manager 3.1.1 includes an HTML installation interface that can simplify the 
installation of Novell Storage Manager 3.1.1 product components. 
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= Novell. Storage Manager 


Configuration Options 


Choose a Directory Service 
D Microsoft Active Directory 
© Novell eDirectory 


Read the EULA 


Clicking either of the directory service options on the left, indicates which component files can be 


Installation 


** Note: MSI based installers should be downloaded, and then installed 
Components 


Engine 
SLES 10 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 
SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 
Events 
SLES 10 
novell-storagemanager-event3.1.1-5.1586.rpm 


novell-storagemanager-event3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.i586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


installed. You can save the component installation file by clicking the file name. 


Prerequisites 
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2.1 


Licensing the Product 


¢ Section 2.1, “Licensing Overview,” on page 11 
+ Section 2.2, “Obtaining a License File,” on page 12 


+ Section 2.3, “Updating a License File,” on page 13 


Licensing Overview 


Novell Storage Manager has three license types: 


Table 2-1 License Types 


License Type Target Customer Intended Use 


Evaluation Customers Allows customers to develop an understanding of the power 
of the product. 


Assessment Partners Produces reports that allow customers to see the scope of 
file system management problems in their environment. 


Shows examples of how a policy-based infrastructure can 
benefit the customer’s environment. 


Production Customers Allows customers to create and run a policy-based 
infrastructure in production in their environment. 


The following table includes a summary of the features enabled in each license type: 


Table 2-2 Feature Summary for License Types 


: ; Assessment Production 
Feature Evaluation License : 3 
License License 
Consistency Check Reports Limited to 100 objectsina Yes Yes 
report 
Anomaly Reports Limited to 100 rows in a Yes Yes 
report 
Trustee Reports No Yes Yes 
Policy Path Reporter (integrated with Limited to 100 rows in a Yes Yes 
Novell File Reporter) report 
Data Migration No No Yes 
Redistribution No No Yes 
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Feature Evaluation License pose SMENI FProguction 
License License 
Managed Objects Limited to 100 concurrent Limited to 100 Yes 
objects concurrent objects 
Manage Operations Check mode can be run for Check mode can Yes 
multiple objects be run for multiple 
simultaneously, but objects 


management action can be simultaneously, but 
taken for only one object at managementaction 


a time. can be taken for 
only one object at a 
time. 
Action Object Support No No Yes 


2.2 Obtaining a License File 


Novell Storage Manager requires a production license file or evaluation license file that you obtain 
from Novell. 


1 Ina Web browser, go to www. storagemanagersupport .com. 
2 On the left side of the Web page, click Licensing. 


A new Web page appears with options for obtaining the license in either eDirectory or Active 
Directory managed network environments. 


= Novello Support Site 
printer friendly = 
Product License — 3.1 
Home 
Version 3.1.x Welcome to the Novell Storage Manager™ (NSM) 3.1 License and Activation page. Here you 
= Download will have the opportunity to either request a Evaluation license key or activate a production license 
= Licensing key, which will immediately be sent to you via e-mail. Please select either license generation server. 
= Documentation 
Version 3.0.x x . A 
Option O eDirectory © Active Directory 
= Download 
= Licensing q 
Ñ Evaluation License 
Version 2.5.x 
= Download You can obtain a free 30 day Serveri Server 
= Licensing Unlimited use evaluation 
= Documentation license for Novell Storage Server2 Server2 
Support Manager by using one of the 
= Forums following servers 
Production License Activation 
Server1 Serveri 
Select one of the following links a S 
t A 
o proceed to a server to S R 
activate your Novell Storage 
Manager license 
Copyright © 2006-2013 Condrey Corporation N ovell e 
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3 Do one of the following: 
¢ Request a trial license by clicking one of the server links in the Trial License region. 


+ After you purchase Novell Storage Manager, activate your production license by clicking 
one of the server links in the Production Action region. 


A new Web page appears with registration fields for you to complete. 
4 Complete the fields and click Submit. 


An e-mail from the License Generator is automatically sent to you with an embedded link for 
accessing the license. 


5 Click the link to access a new Web page with an embedded license file. 


= Novelle Support Site 


Home b 
Version 3.1 
= Download 
= Licensin Novell Storage Manager Version 3.1 
= Documentation A y 
x 
Version 3.0 L r 


= Download 


`A 
r 
Novell Storage Manager © 


= Licensin BOADE mm 
= Documentation 3 

Version 2.5 The link for your license file appears below: 
= Download 


= Licensing NovellStorageManagerV31_NVB.local_Jun-19-2013_LICENSE.DAT 
= Documentation 


Supportx (Please use Right-Click-->Save Target As.. to download the file.) 
= Forums 


Note that if you are replacing a license file in an existing installation, the file must be renamed to 
‘LICENSE.DAT. If you have problems with this file and need assistance, please contact 
support@storagemanagersupport.com 


Copyright © 2006-2013 Condrey Corporation. All Rights Reserved N ove Il a or 


6 Right-click the license file, select Save Target As, then save the license file to a directory of your 
choice. 


7 Note where the license file is saved. 


You need to retrieve the license during the installation of NSMAdmin. 


2.3 Updating a License File 


After you have installed Novell Storage Manager 3.1.1 for eDirectory, you can update your evaluation 
license or production license by simply replacing the old license file with the new one. For more 
information see “Replacing an Unexpired License File” or “Replacing an Expired License File”in the 
Novell Storage Manager 3.1.1 for eDirectory Administration Guide. 
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Upgrading from Storage Manager 2.5x to 
3.11 


Use the procedures in this section to upgrade your deployment of Novell Storage Manager 2.5x for 
eDirectory to Novell Storage Manager 3.1.1 for eDirectory. You should follow these procedures only 
after you have performed the prerequisite tasks in Chapter 1, “Prerequisites,” on page 7, and 
obtained a Novell Storage Manager 3.1.1 for eDirectory product license as indicated in Chapter 2, 
“Licensing the Product,” on page 11. 

+ Section 3.1, “Understanding the Upgrade Process,” on page 15 

+ Section 3.2, “Migration Considerations,” on page 16 

+ Section 3.3, “Clearing Pending Events,” on page 18 
Section 3.4, “Installing NSMAdmin 3.1.1,” on page 19 


Section 3.5, “Running the NSM Migration Utility,” on page 20 


+ 


+ 


+ Section 3.6, “Unloading Novell Storage Manager 2.5x Event Monitor Components,” on page 23 


+ 


Section 3.7, “Unloading Novell Storage Manager 2.5x Agent Components,” on page 23 
+ Section 3.8, “Upgrading the NSM Engine,” on page 24 

+ Section 3.9, “Configuring the NSM Engine,” on page 25 

+ Section 3.10, “Running the NSMAdmin 3.1.1 Setup Wizard,” on page 28 

+ Section 3.11, “Verifying Storage Resource Lists,” on page 31 

+ Section 3.12, “Performing Manage Operations for Migrated Policies,” on page 32 
+ Section 3.13, “Upgrading the Event Monitor,” on page 32 

+ Section 3.14, “Configuring the Event Monitor,” on page 33 

+ Section 3.15, “Upgrading an NSM Agent,” on page 36 

+ Section 3.16, “Configuring an NSM Agent,” on page 37 

+ Section 3.17, “Authorizing the Event Monitor,” on page 40 

+ Section 3.18, “Authorizing the NSM Agents,” on page 40 


Understanding the Upgrade Process 


The upgrade process involves migrating any of your existing Novell Storage Manager 2.5x for 
eDirectory policies as well as deferred delete pending events, then rebuilding the Novell Storage 
Manager catalog. 


Because you are moving the NSM Engine in Novell Storage Manager 2.5x from a NetWare server to a 
Novell Open Enterprise Server 2 machine, you perform an across-the-wire migration. 


Upgrading from Storage Manager 2.5x to 3.11 15 
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3.2 


3.2.1 


3.2.2 


3.2.3 


The migration is a three-step process: 


1. The NSM Migration utility exports policies and deferred delete content from the Novell Storage 
Manager 2.5x NSM Engine. 


2. The NSMAdmin Setup Wizard imports the policies and deferred delete content to the Novell 
Storage Manager 3.1.1 NSM Engine. 


3. You perform Manage Operations to rebuild the Novell Storage Manager catalog. 


Migration Considerations 


As part of the planning process, consider the following: 


+ Section 3.2.1, “Novell Storage Manager 2.0 Customers,” on page 16 

+ Section 3.2.2, “Novell Storage Manager 3.1.1 for eDirectory Components,” on page 16 
¢ Section 3.2.3, “NetWare Support,” on page 16 

+ Section 3.2.4, “Schema Management,” on page 17 


+ Section 3.2.5, “Policy, Catalog, and Pending Event Migration,” on page 18 


Novell Storage Manager 2.0 Customers 


Customers running a version of Novell Storage Manager earlier than 2.5x must upgrade to 2.5x 
before performing a migration. If you choose, you can limit the upgrade to only the NSM Engine 
component. 


NOTE: The Event Monitor and NSM Agents are not involved in the migration process. 


Novell Storage Manager 3.1.1 for eDirectory Components 


All of the components of Novell Storage Manager 3.1.1 for eDirectory are built exclusively for being 
hosted on Novell Open Enterprise Server machines. 

+ For the NSMAdmin requirements, see Section 3.4, “Installing NSMAdmin 3.1.1,” on page 19 

¢ For NFR Engine requirements, see Section 3.8, “Upgrading the NSM Engine,” on page 24. 


+ For the Event Monitor requirements, see Section 3.13, “Upgrading the Event Monitor,” on 
page 32. 


+ For the NSM Agent requirements, see Section 3.15, “Upgrading an NSM Agent,” on page 36. 


NetWare Support 


Novell Storage Manager 3.1.1 for eDirectory can manage storage on NetWare volumes. However, 
unlike previous versions of Novell Storage Manager, there are no components that run on NetWare 
itself. Novell Storage Manager 3.1.1 for eDirectory has been designed to manage storage residing on 
servers running Novell Open Enterprise Server running SUSE Linux or Novell NetWare. 
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3.2.4 


NOTE: Novell Storage Manager 2.5x continues to be fully supported by Novell for Novell Storage 
Manager customers in NetWare environments. 


+ “Event Services” on page 17 


+ “Agent Services” on page 17 


Event Services 


Event Monitors should be configured to monitor at least one server per eDirectory partition ring that 
you care about. That is, you should monitor servers that hold a replica for each eDirectory partition 
that contains objects that you want to receive event data about and for which Novell Storage Manager 
3.1.1 for eDirectory will consequently manage storage. 


NOTE: Novell recommends two Event Monitors per replica ring. 


The Linux-based Event Monitor can monitor events on remote eDirectory servers, not just the local 
server as was the case with all previous versions of Novell Storage Manager for eDirectory. This 
means that the Novell Storage Manager 3.1.1 Event Monitor running on Linux can be instructed to 
monitor existing NetWare servers holding replicas. The Event Monitor running in this configuration 
can be run on either Novell Open Enterprise Server 2 or SUSE Linux Enterprise Server 10, so you do 
not need to introduce new servers into the directory tree if the replicas are on NetWare. Similarly, you 
do not need to move or change any replicas. For more information on Event Monitors, see “Event 
Monitor” in the Novell Storage Manager 3.1.1 for eDirectory Administration Guide. 


Agent Services 


Although the NSM Engine is fully capable of performing all of the storage management work, you 
can improve performance by using the NSM Agents to offload some of the work. Customers can 
deploy NSM Agents on Novell Open Enterprise Server 2 machines in a “proxy mode” to allow them 
to take work for one or more target NetWare servers while still offloading work from the NSM 
Engine. This is an important consideration for Novell Storage Manager customers that are currently 
running storage on NetWare servers that have yet to be migrated to Novell Open Enterprise Server 2. 
For more information on proxy agents, see “Proxy Agents” in the Novell Storage Manager 3.1.1 for 
eDirectory Administration Guide. 


Schema Management 


There are several schema changes that take place in Novell Storage Manager 3.1.1 for eDirectory. 
Most notable for those customers migrating from Novell Storage Manager 2.5x is that schema 
extensions are now done using auxiliary class definitions that can be removed. The attribute names 
for some extensions have also changed. For this reason, the schema is upgraded in the NSMAdmin 
Installation Wizard. For more information on schema extensions, see “Active Directory Schema 
Extensions” in the Novell Storage Manager 3.1.1 for eDirectory Administration Guide. 
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3.2.5 


3.3 


Policy, Catalog, and Pending Event Migration 


With the introduction of Novell Storage Manager 3.1, policy definitions are no longer stored as 
objects in eDirectory, but have been moved to a local database on the server hosting the NSM Engine. 
This results in improved performance and functionality. When you run the NSMAdmin Setup 
Wizard, you are asked if you want to import migration data from Novell Storage Manager 2.5x, 
which includes the policy definitions. 


The Novell Storage Manager 3.1.1 catalog serves two purposes: 


¢ Maintains status information on pending events that are waiting for execution or currently being 
executed 


¢ Maintains static information about the objects and storage that are currently under the 
management of Novell Storage Manager 3.1. 


In previous versions, Novell Storage Manager used a flat file mechanism for maintaining the catalog, 
but for the purpose of improved performance and functionality, Novell Storage Manager 3.1.1 moves 
the catalog to a local database. 


When you run the NSMAdmin Setup Wizard, you can import deferred delete pending events from 
Novell Storage Manager 2.5x. 


The diagram below illustrates the migration process for policy and catalog information from Novell 
Storage Manager 2.5x to Novell Storage Manager 3.1. This process uses the Novell Storage Manager 
3.1.1 Migration utility to produce a metadata file holding relevant data from Novell Storage Manager 
2.5x, which is then injected into the Novell Storage Manager 3.1.1 system. 


Figure 3-1 Migration Process for Policy and Catalog Information 


eDirectory 


NetWare Server 


( Policy| Policy| Policy 


[nsm30 |] |. EA , [ NsM30 
Migration | [— Metadata | [— > | Install 
Utility l 7 i Wizard 


Export L NY, J Import 


OES 2 Server 


NSM 3.0 ayy — 


Clearing Pending Events 


The NSM Migration utility migrates only deferred delete pending events. Therefore, before 
beginning with the procedures in this section, you should clean up all pending events except for 
deferred delete events. 


NOTE: A deferred delete event is the scheduled deletion of a user home folder or a collaborative 
storage folder. It has not yet taken place because the number of days in the Cleanup Storage 
parameter of the policy has not been met. 
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3.4 


Installing NSMAdmin 3.1.1 


The NSMAdmin 3.1.1 installation package includes the NSM Migration utility, which you need to 
install on the server where the Novell Storage Manager 3.1.1 NSM Engine will eventually be hosted. 


NSMAdmin can be installed on a Windows server or workstation that meets the following minimum 
requirements: 


+ Windows platform (Windows 7, Vista, XP SP3, and Windows Server 2012, 2008 or 2003) 
+ NET 3.5 Framework and .NET 4.0 (Full) Framework installed. 


+ .NET security settings are adjusted if you are running the executable from a network drive 
(optional) 


1 At the root of the NSM_3_1_1.iso image, click the install .html file. 


= Novell. Storage Manager 


— Installation 


** Note: MSI based installers should be downloaded, and then installed 


Configuration Options Components 


Choose a Directory Service Engine 
D Microsoft Active Directory SLES 10 

(A Novell eDirectory novell-storagemanager-engine3.1.1-42.x86_64.rpm 
SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Read the EULA 
Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.i586.rpm 
novell-storagemanager-event-3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


2 Select Novell eDirectory. 
3 Click NSMAdmin-3.3.3-xxxx.msi. 


4 When asked if you want to save or run the file, save the file to the hard drive of a computer 
where you will administer Novell Storage Manager. 


5 From the saved location, launch the NSMA dmin installation file. 
6 When you are asked if you want to run this file, click Run. 

An Introduction page appears in the NSMAdmin Installation Wizard. 
7 Read the text and click Next. 
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8 Accept the license terms and click Next. 
9 Accept the installation path or indicate a new path by using the Browse button. 


To review possible locations, you can click Disk Usage to see all available volumes with disk size 
and disk availability data. 


10 Click Next. 


11 If you want to create a shortcut for NSMAdmin, leave the Create shortcut on Desktop check box 
selected and click Install. 


NSMA dmin is installed. 
12 Deselect the Launch NSMAdmin 3 check box, which is selected by default, and click Finish. 


3.5 Running the NSM Migration Utility 


This procedure creates the file for exporting your policies and deferred delete events from your 
Novell Storage Manager 2.5x NSM Engine. 


1 At workstation where you installed NSMAdmin, click Start > All Programs > Novell > Storage 
Manager > NSM Migration Utility. 
This launches a migration wizard. 


IG Novell Storage Manager 3.0 - Migration Export Wizard 


Welcome 


+ Welcome 
Set Staging Data Novell Storage Manager 3.0 
Location Migration Export Wizard 


Prepare Engine This wizard will guide you through the process of exporting existing Policies and Pending Event data as 
part of the upgrade process of Novell Storage Manager from version 2.5 to version 3.0. 
Export Policies 


Important: The current Engine service should be running and rernain in a steady state where it is neither 
Export Pending accepting new events nor processing existing ones. The Migration Export Wizard will issue commands to 
Events set the Engine in the Not Accepting and Not Processing states. 


Finish For complete guidelines, see the Novel! Storage Manager 3.0 Installation Manual. 


Click Next to initiate the login to the Novell Storage Manager 2.5 Engine. 


Version: 3.0.0.9 


2 Read the text and click Next. 


The following login window appears: 


Novell Storage Manager 3.1.1 for eDirectory Installation Guide 


€Tog Jaquiajdas gz (us) sAso0p 


8) Novell Storage Manager 3.0 Migration Utility - 3.0.0.16 


© Novelle Storage Manager 


Engine [10.250.101.110 y] Port [3009 
User Name [admin.system 
Password | 


Copyright © 2010 Condrey Corporation. All rights reserved. 


3 Log in to the server hosting the Novell Storage Manager 2.5x NSM Engine by specifying the 
server’s DNS name or IP address in the Engine field, specifying the port number, administrator 
name, and password, then clicking Login. 


The following page appears: 


IG Novell Storage Manager 3.0 - Migration Export Wizard 
Set Staging Data Location 


vV Welcome 
q Select a location for the exported Policy and Event data. 
Set Staging Data 
Location A folder based on the current Directory Services tree name NVB.local will be created in this location for the 
migration data. 


+ 


Prepare Engine 


Export Policies 


Export Pending 
Events 


Finish 


Path iser's\ administrator .NVB\AppDatalRoaming|Novell\Storage Manageri NSMAdmin v3\MigrationData 


Version: 3.0.0.9 


4 Accept the path where the migration file will be stored, or indicate a new one by using the 
Browse button, then click Next. 


Unless you change the default path, the path appears automatically when you import the 
migration file through the NsMAdmin Setup Wizard. 


The following page appears: 
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IG Novell Storage Manager 3.0 - Migration Export Wizard 


v Welcome 


Set Staging Data 


v Ñ 
Location 


Prepare Engine 


Export Policies 


Export Pending 
Events 


Finish 


Version: 3.0.0.9 


Prepare Engine 


All event processing must be disabled before continuing. 
Click Stop Event Services if any of the processes are still running. 


Once Accepting and Processing are both disabled, click Next to continue. 


Current Engine Status 
E) Accepting Events 


5 Click Stop Event Services, then click Next. 


This stops the Novell Storage Manager 2.5x NSM Engine from accepting and processing events. 


6 Click Next. 


A page similar to the following appears: 


IG Novell Storage Manager 3.0 - Migration Export Wizard 


Welcome 


Set Staging Data 
Location 


Prepare Engine 


Export Policies 


Export Pending 
Events 


Finish 


Version: 3.0.0.9 


Export Policies 


T Use FDN Policy Names Ai Rename | WA selectall Select None | (Reload All Policy Data | 
| | Original Policy (2) | New Policy (2) 
IS A CN=Henderson Users, OU=Henderson,DC=N... Henderson Users 
[> IS aA CN=Las Vegas Policy, OU=Las Vegas,DC=MWB... Las Vegas Policy 


@ New Policy Name entries may be edited. Select a New Policy cell and press F2 or start typing to edit, 


L IE 


7 Indicate the Novell Storage Manager 2.5x policies you want migrated by leaving the 
corresponding policy check boxes selected. 
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You can rename a policy before migrating it by editing the name listed in the New Policy column. 
Clicking the Use FDN Policy Names check box displays the fully distinguished name, which you 
can also edit. 


If you have a policy displayed with a red error symbol, this indicates that the policy cannot be 
exported. Typically, this is due to a missing policy type attribute, possibly from a policy created 
before the release of Novell Storage Manager 2.5x that was updated but did not properly convert 
to the Novell Storage Manager 2.5x environment. 


Once you have fixed these policies to conform to Novell Storage manager 2.5x standards, you 
can run the Migration utility again. If the polices do no appear, click Reload All Policy Data. 


At this point in the migration, if you quit and restart the Migration utility, any changes or edits 
(such as policy renames, and selection of policies to import) that have been performed are 
actually saved and reloaded the next time you run the Migration utility. However, if you add 
any new policies or fixed any, those changes may not show up on a subsequent run of the 
Migration utility until you click Reload All Policy Data. 


8 Click Next. 
The wizard exports the policies to the migration file and indicates when the export is complete. 
9 Click Next. 


The wizard exports the deferred delete events to the migration file and indicates when the 
export is complete. 


10 Click Next. 


A concluding wizard page appears with procedures for importing the migration file to the 
Novell Storage Manager 3.1.1 NSM Engine. 


11 Read the summary of procedures and click Finish. 


12 Proceed with Section 3.6, “Unloading Novell Storage Manager 2.5x Event Monitor 
Components,” on page 23. 


3.6 Unloading Novell Storage Manager 2.5x Event Monitor 
Components 


1 Ateach server console hosting Novell Storage Manager 2.5x Event Monitors, unload or stop 
each Event Monitor and confirm that the event processing has stopped. 


2 Remove associated load commands in the autoexec.ncf file from NetWare, and disable 
analogous components on Open Enterprise Server 2 and SUSE Linux Enterprise Server 10 
machines. 


3 Proceed with Section 3.7, “Unloading Novell Storage Manager 2.5x Agent Components,” on 
page 23. 


3.7 Unloading Novell Storage Manager 2.5x Agent Components 


1 At each server console running Novell Storage Manager 2.5x NSM Agents, unload or stop each 
NSM Agent and confirm that these processes have stopped. 


2 Remove associated load commands in the autoexec .ncf file from NetWare, and disable 
analogous components on Open Enterprise Server 2 and SUSE Linux Enterprise Server 10 
machines. 


3 Proceed with Section 3.8, “Upgrading the NSM Engine,” on page 24. 
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3.8 Upgrading the NSM Engine 


Novell Storage Manager uses only one NSM Engine per tree. The NSM Engine can be installed on a 
machine that meets the following minimum requirements: 

+ Novell Open Enterprise Server 2 SP2a or later with an x64 processor 

+ Novell Open Enterprise Server 11 SP1 with Jan. 2013 Maintenance release or later 


¢ eDirectory 8.7.3.9 or later; or eDirectory 8.8 SP 2 or later 


1 At the root of the NSM_3_1_1.iso image, click the install .html file. 


= Novell. Storage Manager 


— Installation 


** Note: MSI based installers should be downloaded, and then installed 


Configuration Options Components 


Choose a Directory Service Engine 
D Microsoft Active Directory SLES 10 
© Novell eDirectory novell-storagemanager-engine-3.1.1-42.x86_64.rpm 
SLES 11 
novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Read the EULA 
Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.i586.rpm 
novell-storagemanager-event3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


2 Select Novell eDirectory. 


3 Under the platform on which you are installing the NSM Engine, click novell-storage-manager- 
engine-3.1.1-xx.x86_64.rpm. 


4 Save the RPM. 
5 Launch a terminal session. 
6 Upgrade the NSM Engine RPM package by typing: 
# rpm -U novell-storage-manager-engine-3.1.1-xx.x86_64.rpm. 


7 Follow the installation procedures as directed in the NSM Engine installation interface. 
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3.9 Configuring the NSM Engine 


1 From the server where you installed the NSM Engine, launch a terminal session by selecting 
Computer > Gnome Terminal. 


2 Type nsmengine-config and press Enter. 


The console is updated and looks similar to the one below. 


Terminal 


File Edit View Terminal Tabs Help 


Engine Service Setup Wizard 

Please fill in the following required fields: 
Current Address: 127.0.0.1 

Select new Engine address: 

[0] 172.17.2.15 


Selection-> 


If your server has multiple NIC cards, multiple IP address options are listed. 
3 Specify the IP address option you want (such as 0 in the example above) and press Enter. 
4 When the HTTP Port [0] option appears, type 0 and press Enter. 


The console is updated and looks similar to the one below: 
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Terminal 


File Edit View Terminal Tabs Help 


Engine Service Setup Wizard 

Please fill in the following required fields: 
Current Address: 127.0.0.1 

Select new Engine address: 


[0] 172.17.2.15 


Selection->0 
Engine HTTP Port [0] : 
Engine HTTPS Port [3009] : fj 


5 Unless there is a conflict, accept the default HTTPS port number of 3009 by pressing Enter. If you 
need to use another port number, provide the new port number. 


6 When you are asked if you want to start the service, click Y for yes. 
This starts the NSM Engine. 
7 Press Enter to continue. 


The console is updated and looks similar to the one below. 
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Terminal 


File Edit View Terminal Tabs Help 


serial:B7:D2:63:AF:5E:28:74:0A 


X509v3 Basic Constraints: 
CA: TRUE 
Signature Algorithm: shalWithRSAEncryption 

73:b9:da:31:27:a1:75:a3:cc:23:dc:70:19:c3:b3:06:4e:f£8: 
a6:55:13:c1:386:70:ae:ed:cc:6e:9c:6e:6a:47:f£3:ee:0e:87: 
£5:8c:40:79:82a:26:£2:a7:73:07:d6:ef£:97:d3:88:b8:3b:90: 
b9:2e:07:a1l:ea:00:e4:d2:8b:53:15:fa:a5:6£:£5:89:45:2a: 
4b:9%1:5a:93:2d:9e:44:3£:86:d9:10:a£:80:5c:d8:80:db:9£: 
0e:3e:b5:28:c6:£1:45:ad:00:cd:f9%:dd:1f:4f:ad:4e:3a:58: 
£5:02:b5:e4:32:d3:46:ba:3f£:el:d2:4£:91:9£:60:11:5c:fd: 
57:58:bc:14:2c:66:8£:54:e7:05:ee:da:d6:d0:ae:29:ca:ef: 
b0:7b:8b:ca:0a:9£:03:9%b:aa:4d:3e:92:dd:dc:32:ee:4£:67: 
%4a:86:12:03:12:7d:d3:d0:e6:ef:ea:£6:75:b4:b9:52:el:bl: 
be:f1:2f:ba:e9:88:b8:cf£:c9:00:b9:3b:d0:b8:b3:79:92:c3: 
ba:7b:c6:5d:51:04:c5:89:4b:97:c8:97:£6:2c:20:d5:a4:69: 
de:04:86:39:57:8d:15:c1:35:db:27:d3:36:77:£1:98:63:£4: 
23:ca:cl:c7:78:da:14:la:78:05:3b:db:90:6d:b4:d5:3£:89: 
ec:Tb:fc:a% 


Press [Enter] to continue. 


U 


8 Press Enter to create the server certificate and to continue. 


The console is updated and looks similar to the one below. 


Terminal 


Address: 10.112.20.1 

HTTP Port: o 

HTTPS Port 3009 
sawgrass-edir.brett-dev.condreycorp.com 


Engine Settings [N] Default NCP Server Address 


Service Management [C] Certificate Management 
Quit 


At this point, you can navigate through the menu to see how to perform management tasks on 
the NSM Engine when necessary. 


9 Press q to quit. 
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3.10 Running the NSMAdmin 3.1.1 Setup Wizard 


With the Novell Storage Manager 3.1.1 NSM Engine installed, you can now run the NSMAdmin 
Setup Wizard to import the migration file you created in Section 3.5, “Running the NSM Migration 
Utility,” on page 20. 


1 From your desktop, double-click the NSMAdmin icon. 


The login window appears. 


Novell Storage Manager Admin Client - 3.0.4.4 


© Novello Storage Manager 


Engine 10.112.20.1 Port 3009 
UserName admin.sawgrass 


Password eeeeeee 


> Proxy and Logging Options 


Copyright © 2002-2012 Condrey Corporation. All rights reserved. 8 


2 In the Engine field, specify the DNS name or IP address. 
3 In the Port field, specify the secure port number. 
The default setting is 3009. 
4 Specify the username and password. 
The user must be a member of the NSMAdmins group to be able to log in. 
5 Click Login. 


If you are unable to log in, your proxy settings might be preventing you from doing so. Until you 
enter a proxy exception in your proxy settings, you can click Proxy and Logging Options, select Do 
not use a Proxy, then click Login. 


The Setup Wizard welcome screen appears. 
6 Read the text on the screen and click Next. 
7 Do one of the following: 
+ Click Browse to locate and select the path to the license file. 
+ Click Get a License to obtain an evaluation license. 
8 Click Next. 


9 Inthe Proxy Service Account and Proxy Service Group fields, accept the account names that will be 
created and click Next. 
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Novello Storage Manager 


Novell Storage Manager needs to create a service proxy account, By 
default, this account will be created inthe same container as the logged 
-in user. If desired, a different container and account name may be 
entered using a fully distinguished name like ProxyUser.OU1.0U.ORG. 


Service Proxy Account NSMProxy.novell 


Cancel 


10 Accept or modify the NSM Administrators’ group name, leave the Add current user to the NSM 
Administrators Group check box selected, then click Next. 


11 When you are notified that a Proxy Home share will be created on the engine's local Proxy 
Home source path, click Next. 


The following page appears: 
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© Novella Storage Manager 


Complete Migration 


Ifyou are completing a migration from Novell Storage Manager, select 
the Complete Migration checkbox, then click Next to continue. 


Ifthis is a new install, simply click Next to continue. 


T" Complete Migration 
Migration Staging Área Path: 


C;\\Users\ Administrator 4ppData\Roaming\Novell\Storage Manag Browse 


Back Next Cancel 
next | 


12 If you want to import your policies at this time, select the Complete Migration check box. If you 
modified the path where the migration file was saved in Step 4 on page 21, indicate the path by 
using the Browse button, then click Next. 


If you choose not to import the policies at this time, you can do so later in NSMAdmin using the 
Import Upgraded Policies. 


A message appears informing you that the import is complete. 
13 Click Next. 
The NSM Migration utility shows the deferred delete events that are to be migrated. 
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15 


16 
17 
18 
19 


© Novello Storage Manager 


Import Defered Pending Events 


Object FDN | Path 

CN=Bill Blair, OU=Henderson,DC=N...  \\NVB-RENO\SharedYolume... 
CN=Jules Taylor,OU=Henderson,D...  YNWYB-RENO¡SharedYolume... 
CN=Marie Taylor,OU=Henderson,D...  1NWWB-RENO|SharedYolume... 
CN=Pat Olson, OU=Henderson,D... \WNYB-RENO\SharedYolume... 


Successfully loaded 4 Pending Events. Click 'Next' to continue the import. 


Back oo | Cancel | 


Click Next. 


A message appears informing you that Novell Storage Manager needs to initialize the engine 
and its subsystems. 


Click Next. 

When the initialization is complete, the NSMAdmin 3.1.1 login window appears. 
Log in to NSMAdmin. 

In the Main tab, click Policy Management to see the imported policies. 

Click Pending Events to see the deferred delete events. 


Proceed with Section 3.11, “Verifying Storage Resource Lists,” on page 31. 


3.11 Verifying Storage Resource Lists 


1 InNSMAdmin, click the Main tab and Select Storage Resource List. 


2 Verify that all server and volumes are listed. 


3 


(Conditional) If they are not listed, select Rebuild. 


It might take a few minutes for Novell Storage Manager to scan all of eDirectory for volumes. 


4 When the list is complete, click Continue. 


5 Proceed with Section 3.12, “Performing Manage Operations for Migrated Policies,” on page 32. 
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3.12 Performing Manage Operations for Migrated Policies 


The final step in the migration process is to rebuild catalog information for managed users, groups, 
and storage from eDirectory and the file system. Perform the following sets of steps for users 
managed by user policies and for groups and containers managed by collaborative policies. 


This procedure rebuilds catalog information for storage for all users in a specific container of a 
directory tree. 

1 In NSMAdmin, click the Main tab and select Storage Management. 

2 Right-click a container in the left panel and select Users Actions > Manage. 
3 With Run in Check Mode selected, click Run. 
4 Select Expand to view the results. 
5 Click the Action column to sort. 


If there is no applicable policy for users in the container, no action is taken because these users 
are not managed by Novell Storage Manager. 


6 Click Collapse. 

7 Deselect Run in Check Mode and click Run. 

8 Click Consistency Check. 

9 Click Expand. 
10 Click the Policy column to sort by policy. 
11 Verify that the users are now managed. 
12 Close the Take Action form. 


13 Repeat these steps for all groups and containers that have an associated policy that was 
migrated. 


For Group objects, you must select Group Actions > Manage. 
For Container objects, you must select Container Actions > Manage. 


14 Proceed with Section 3.13, “Upgrading the Event Monitor,” on page 32. 


3.13 Upgrading the Event Monitor 


The Event Monitor can be installed on either of the following servers: 


+ Novell Open Enterprise Server 2 SP2a or later with an x86 or x64 processor 
+ SUSE Linux Enterprise Server 10 SP2 or later with an x86 or x64 processor 


+ Novell Open Enterprise Server 11 SP1 with Jan. 2013 Maintenance release or later 
Other notable information about the Event Monitor: 


¢ You can have multiple Event Monitors per directory tree 


¢ The Event Monitor must be permitted to make outbound connections through the firewall 


1 At the root of the NSM_3_1_1.iso image, click the install .html file. 
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= Novell. Storage Manager 
— Installation 


** Note: MSI based installers should be downloaded, and then installed 


Configuration Options Components 


Choose a Directory Service Engine 
Microsoft Active Directory SLES 10 


(A Novell eDirectory novell-storagemanager-engine-3.1.1-42.x86_64.rpm 
SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Read the EULA 
Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.1586.rpm 
novell-storagemanager-event-3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


2 Select Novell eDirectory. 


3 Under the platform on which you are installing the Event Monitor click novell-storage-manager- 
event-3.1.1-x.xxxx.rpm. 


4 Save the RPM. 
5 Launch a terminal session. 


6 Upgrade the NSM Event Monitor RPM package by typing: 


# rpm -U novell-storage-manager-event-3.1.1-x.xxxx.rpm. 


7 Follow the installation procedures as directed in the Event Monitor installation interface. 


3.14 Configuring the Event Monitor 


1 From the server where you installed the Event Monitor, launch a terminal session by selecting 
Computer > Gnome Terminal. 


2 Type nsmevent -config and press Enter. 


The console is updated and looks similar to the one below. 
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Terminal 


Edit View Terminal Tabs Help 


Event Service Setup Wizard 

Please fill in the following required fields: 
Current LDAP Address: 127.0.0.1 

Select new LDAP address: 


[0] 172.17.2.15 
[1] Another Server 


Selection-> 


3 Specify the IP address of the LDAP server you are going to monitor. 


For example, if you are going to monitor this server, type 0. If you are going to monitor another 
server, type 1 and then type the IP address and other configuration information that is 
requested. 


Event monitors should be configured to monitor at least one server per eDirectory partition ring 
that you care about. That is, you should monitor servers that hold a replica for each eDirectory 
partition that contains objects that you want to receive event data about and for which NSM will 
consequently manage storage. 


4 Press Enter. 


The console is updated and looks similar to the one below. 
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Terminal 


File Edit View Terminal Tabs Help 


Event Service Setup Wizard 

Please fill in the following required fields: 
Current LDAP Address: 127.0.0.1 

Select new LDAP address: 


[0] 172.17.2.15 
[1] Another Server 


Selection->0 

Configure Ports: 

Enter new port values 

For each of the following, enter a port number. 

(Enter zero (0) to turn off a port listener or hit [Enter] to accept 


the current value.) 


LDAP Port [389]: 


5 Accept the default LDAP port setting by pressing Enter. 
6 Accept the TLS-Auth LDAP SSL type by pressing Enter. 
7 Accept the default data path by pressing Enter. 


The console is updated and looks similar to the one below. 


Terminal 


File Edit View Terminal Tabs Help 


Configure Ports: 
Enter new port values 


For each of the following, enter a port number. 
(Enter zero (0) to turn off a port listener or hit [Enter] to accept 
the current value.) 


LDAP Port [389]: 


LDAP SSL Type: 
Clear 

SSL 

TLS-Auth 


Current Data Path: /var/opt/novell/storagemanager/event 
New Path-> 
Engine Address [127.0.0.1] 


8 Specify the IP address of the server hosting the NSM Engine and press Enter. 
You can also enter a DNS entry at this prompt. 
9 Accept the port entry of 3009 by pressing Enter. 
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10 When you are asked if you want to start the service, press y for yes. 
This starts the Event Monitor. 
11 Press Enter to continue. 


The console is updated and looks similar to the one below. 


Terminal 


File Edit View Terminal Tabs Help 


LDAP Address: 172.17.2.15 
LDAP Port: 389 
LDAP SSL Type: TLS-Auth 


Data Path: /var/opt/novell/storagemanager/event 
Heartbeat: 60 seconds 
Engine Address: 172.17.2.15:3009 


LDAP Address LDAP Ports & Settings 
Data Path Debug Options 

Service Management Engine Service 

View Console 2] Quit 


Selection->fj 


At this point, you can navigate through the menu to see how to perform management tasks on 
the Event Monitor when necessary. 


12 Press q to quit. 


3.15 Upgrading an NSM Agent 


An NSM Agent can be installed on any of the following machines: 


+ Novell Open Enterprise Server 2 SP2a or later with an x86 or x64 processor 


+ Novell Open Enterprise Server 11 SP1 with Jan. 2013 Maintenance release or later 
Other notable information about NSM Agents: 


+ The default NSM Agent port is 3011 
¢ A firewall inbound rule for the NSM Agent is created during the installation 


1 At the root of the NSM_3_1_1.iso image, click the install .html file. 
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= Novell. Storage Manager 
— Installation 


** Note: MSI based installers should be downloaded, and then installed 


Configuration Options Components 


Choose a Directory Service Engine 
Microsoft Active Directory SLES 10 


(A Novell eDirectory novell-storagemanager-engine-3.1.1-42.x86_64.rpm 
SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Read the EULA 
Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.1586.rpm 
novell-storagemanager-event-3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


2 Select Novell eDirectory. 


3 Under the platform on which you are installing the NsMAgent, click novell-storage-manager- 
agent-3.1.1-xXx.xxXx.rpm. 


4 Save the RPM. 
5 Launch a terminal session. 


6 Upgrade the NSM Agent RPM package by typing: 


# rpm -U novell-storage-manager-agent-3.1.1-xx.xxx.rpm. 


7 Follow the installation procedures as directed in the NSM Agent installation interface. 


3.16 Configuring an NSM Agent 


1 From the server where you installed the NSM Agent, launch a terminal session by selecting 
Computer > Gnome Terminal. 


2 Type nsmagent -config and press Enter. 


The console is updated and looks similar to the one below. 
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Terminal 


File Edit View Terminal Tabs Help 


Agent Service Setup Wizard 

Please fill in the following required fields: 
Current Host Address: 127.0.0.1 

Select new host address: 

[0] 172.17.2.15 


Select ion->fj 


If your server has multiple NIC cards, multiple IP address options are listed. 
3 Specify the IP address option you want (such as 0 in the example above) and press Enter. 
4 When the HTTP Port [0] option appears, type 0 and press Enter. 


The console is updated and looks similar to the one below. 


Terminal 
File Edit View Terminal Tabs Help 
Agent Service Setup Wizard 
Please fill in the following required fields: 
Current Host Address: 127.0.0.1 
Select new host address: 
[0] 172.17.2.15 
Selection->0 


Configure Ports: 
Enter new port values 


For each of the following, enter a port number. 
(Enter zero (0) to turn off a port listener or hit [Enter] to accept 
the current value.) 


Agent HTTP Port [0]: 
Agent HTTPS Port [3011]: 


5 Accept the port setting of 3011 by pressing Enter. 
6 Accept the default data path by pressing Enter. 


7 When you are asked if you want to create the new data path, press y for yes. 
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8 When you are prompted for the engine address, specify the IP address for the server hosting the 


NSM Engine. 


9 Accept the 3009 port setting for the NSM Engine by pressing Enter. 


The console is updated and looks similar to the one below. 


File Edit View Terminal Tabs 


Current Host Address: 127.0.0.1 
Select new host address: 

[0] 172.17.2.15 

Selection->0 

Configure Ports: 


Enter new port values 


For each of the following, ente 


Terminal 


Help 


r a port number. 


(Enter zero (0) to turn off a port listener or hit [Enter] to accept 


the current value.) 
Agent HTTP Port [0]: 


Agent HTTPS Port [3011]: 


Current Data Path: /var/opt/nov 
New Path-> 


ell/storagemanager/agent/data 


Path does not exist. Create path? [Y/N]: y 


Engine Address [] : 172.17.2.15 
Engine Port [3009] 
Use SSL (Y/N) [Y]: J 


10 When you are asked if you want to use SSL, press y for yes. 


11 When you are asked if you want to start the service, press y for yes. 


12 


This starts the NSM Agent. 


Press Enter to continue. 


The console is updated and looks similar to the one below. 


File Edit View Terminal Tabs Help 


Host Address: 
Service Ports: 


Data Path: 
Heartbeat: 
Engine Address: 
Use SSL: 
Default NCP Server Address: 


Agent Address 
Engine Service 
Debug Options 
Service Management 


Selection->[] 


Terminal 


10.112.20.1 
HTTPS: 3011 HTTP: O 


/var/opt/novell/storagemanager/agent/data 
60 seconds 

10.112.20.1:3009 

Yes 
sawgrass-edir.brett-dev.condreycorp.com 


Data Path 

NCP Server Address 
Agent Ports 

Quit 
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13 


At this point, you can navigate through the menu to see how to perform management tasks 
when necessary. 


Press q to quit. 


3.17 Authorizing the Event Monitor 


N Oo oO SI RF 


In NSMAdmin, click the Configure tab. 

Click Event Servers. 

Select the listed server. 

Click the check mark button. 

When you are asked if you want to authorize the selected event monitor, click Yes. 
When the Results page appears, click Close. 

Proceed with Section 3.18, “Authorizing the NSM Agents,” on page 40. 


3.18 Authorizing the NSM Agents 


1 
2 
3 
4 
5 
6 


In NSMAdmin, click the Configure tab. 

Click Agent Servers. 

Select a listed server. 

Click the check mark button. 

When you are asked if you want to authorize the selected event monitor, click Yes. 


When the Results page appears, click Close. 
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4.1 


4.2 


Upgrading from Storage Manager 3.x to 
3.1.1 


¢ Section 4.1, “Overview,” on page 41 

+ Section 4.2, “Upgrading the NSM Engine,” on page 41 

+ Section 4.3, “Upgrading the Event Monitor,” on page 42 
+ Section 4.4, “Upgrading the NSM Agent,” on page 43 

+ Section 4.5, “Upgrading NSMAdmin,” on page 44 


IMPORTANT: Novell Storage Manager 3.1.1 requires a 64-bit host for the NSM Engine. If you are 
upgrading from a 32-bit host, the procedures in this chapter are not applicable. 


Overview 


The process for upgrading Novell Storage Manager 3.x to Novell Storage Manager 3.1.1 is to simply 
install the NSM Engine, Event Monitors, and NSM Agents on the same machines that are hosting the 
Novell Storage Manager components. You must also update your version of NSMAdmin. 


If you are upgrading from Novell Storage Manager 3.0.x, you must update the product license using 
NSMAdmin. 


IMPORTANT: Novell Storage Manager 3.1.1 is engineered to work only with corresponding Version 
3.1.1 components. In other words, if you update your NSM Engine to Version 3.1.1, you must also 
update all Event Monitors and NSM Agents to Version 3.1.1. In addition, you must also update your 
version of NSMAdmin to the new version included on your Novell Storage Manager 3.1.1 product 
ISO. 


Upgrading the NSM Engine 


NOTE: With the exception of a now mandatory 64-bit server host, the system requirements and 
prerequisite tasks have not changed significantly since you installed the Novell Storage Manager 
3.0.x NSM Engine. Therefore, they are excluded from this section. If you want to review them, refer to 
Section 5.1, “Installing the NSM Engine,” on page 53. 


1 At the root of the NSM_3_1_1.iso image, click the install .html file. 
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Novell. Storage Manager 


Installation 


** Note: MSI based installers should be downloaded, and then installed 


Configuration Options Components 


Choose a Directory Service Engine 
Microsoft Active Directory SLES 10 

@© Novell eDirectory novell-storagemanager-engine-3.1.1-42.x86_64.rpm 
SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Read the EULA 
Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.1586.rpm 
novell-storagemanager-event-3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


2 Select Novell eDirectory. 


3 Under the platform on which you are installing the NSM Engine, click novell-storage- 
manager-engine-3.1.1-xx.x86_64.rpm. 


4 Save the RPM. 
5 Launch a terminal session. 


6 Upgrade the NSM Engine RPM package by typing: 


# rpm -U novell-storage-manager-engine-3.1.1-xx.x86 64.rpm 


4.3 Upgrading the Event Monitor 


NOTE: The system requirements and prerequisite tasks have not changed significantly since you 
installed the Novell Storage Manager 3.0.x Event Monitor. Therefore, they are excluded from this 
section. If you want to review them, refer to Section 5.3, “Installing the Event Monitor,” on page 56. 


1 At the root of the NSM_3_1_1.iso image, click the install .html file. 
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4.4 


Novell. Storage Manager 


Configuration Options 


Choose a Directory Service 
Microsoft Active Directory 
® Novell eDirectory 


Read the EU 


2 Select Novell eDirectory. 


Installation 


** Note: MSI based installers should be downloaded, and then installed 


Components 


Engine 

SLES 10 
novell-storagemanager-engine-3.1.1-42.x86_64.rpm 

SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.1586.rpm 
novell-storagemanager-event-3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


3 Under the platform on which you are installing the Event Monitor, click novell-storage-manager- 


event-3.1.1-xx.xxx.rpm. 
4 Save the RPM. 


5 Launch a terminal session. 


6 Install the NSM Engine RPM package by typing: 


# rpm -U novell-storage-manager-event-3.1.1-xx.xxx.rpm 


Upgrading the NSM Agent 


NOTE: The system requirements and prerequisite tasks have not changed significantly since you 
installed the Novell Storage Manager 3.0.x NSM Agent. Therefore, they are excluded from this 
section. If you want to review them, refer to Section 5.5, “Installing an NSM Agent,” on page 60. 


1 At the root of the NSM_3_1_1.iso image, click the instal1.html file. 
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Novell. Storage Manager 


Installation 


** Note: MSI based installers should be downloaded, and then installed 


Configuration Options Components 


Choose a Directory Service Engine 
Microsoft Active Directory SLES 10 


(A Novell eDirectory novell-storagemanager-engine-3.1.1-42.x86_64.rpm 
SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Read the EULA 
Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.1586.rpm 
novell-storagemanager-event-3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


2 Select Novell eDirectory. 


3 Under the platform on which you are installing the NSM Agent, click novell-storage-manager- 
agent-3.1.1-xX.XXXX.1pM. 


4 Save the RPM. 
5 Launch a terminal session. 


6 Install the NSM Engine RPM package by typing: 


# rpm -i novell-storage-manager-agent-3.1.1-xx.xxxx.rpm 


4.5 Upgrading NSMAdmin 


NOTE: The system requirements and prerequisite tasks have not changed significantly since you 
installed the Novell Storage Manager 3.x NSMAdmin. Therefore, they are excluded from this section. 
If you want to review them, refer to Section 5.7, “Installing and Configuring NSMAdmin,” on 

page 64. 


1 At the root of the NSM_3_1_1.iso image, click the install .html file. 
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= Novell. Storage Manager 


— Installation 


** Note: MSI based installers should be downloaded, and then installed 


Configuration Options Components 


Choose a Directory Service Engine 
D Microsoft Active Directory SLES 10 

@© Novell eDirectory novell-storagemanager-engine-3.1.1-42.x86_64.rpm 
SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Read the EULA 
Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.1586.rpm 
novell-storagemanager-event-3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


2 Select Novell eDirectory. 
3 Click NSMAdmin-3.1.1-xxxx.msi. 


When asked if you want to save or run the file, save the file to the hard drive of a computer 
where you will administer Novell Storage Manager. 


5 From the saved location, launch the NSMA dmin installation file. 


6 When you are asked if you want to run this file, click Run. 


An Introduction page appears in the NSMAdmin Installation Wizard. 


7 Read the text and click Next. 


8 Accept the license terms and click Next. 


9 Accept the installation path or indicate a new path by using the Browse button. 


10 


12 


To review possible locations, you can click Disk Usage to see all available volumes with disk size 
and disk availability data. 


Click Next. 


If you want to create a shortcut on the desktop, leave the Create shortcut on Desktop check box 
selected and click Install. 


NSMA dmin is installed. 
Leave the Launch NSMAdmin 3 check box selected and click Finish. 
NSMAdmin is launched. 
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13 
14 


15 


16 


17 
18 


19 
20 


Novell Storage Manager Admin Client - 3.0.4.4 


© Novella Storage Manager 


Engine 10.112.20.1 Port 3009 
User Name admin.sawgrass 


Password eeeeeee 


K Proxy and Logging Options 


Copyright © 2002-2012 Condrey Corporation. All rights reserved. 4 


In the Engine field, specify the DNS name or IP address. 

In the Port field, specify the secure port number. 

The default setting is 3009. 

Specify the username and password. 

The user must be a member of the NSMAdmins group to be able to log in. 
Click Login. 


If you are unable to log in, your proxy settings might be preventing you from doing so. Until you 
enter a proxy exception in your proxy settings, you can click Proxy and Logging Options, select Do 
not use a Proxy, then click Login. 


The Setup Wizard welcome page appears. 

Read the text on the page and click Next. 

Do one of the following: 
+ Click Browse to locate and select the path to the license file. 
+ Click Get a License to obtain an evaluation license. 

Click Next. 


The following page appears, asking if you want to extend the Novell eDirectory schema. 
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Setup 


© Novello Storage Manager 


Novell Storage Manager requires extentions to the eDirectory schema. 


There are no side effects to re-applying the schema extensions to an 
existing installation. 


IMPORTANT: Be sure that time is synchronized to the network on the 
server holding the Master replica of the [ROOT] partition. 


NOTE: If you are applying maintenance to a pre-existing installation, 


you should reapply the schema as there have been updates. Novell 
Storage Manager will not run without these newer updates! 


Extend the schema 


If you plan to manage collaborative storage or auxiliary user storage, you must extend the 
eDirectory schema. 


21 Click Next. 
The following page appears: 
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Novella Storage Manager 


Novell Storage Manager needs to create a service proxy account. By 
default, this account will be created in the same container as the logged 
-in user. If desired, a different container and account name may be 
entered using a fully distinguished name like ProxyUser.OU1.OU.ORG. 


Service Proxy Account ISMProxy.novell 


22 Accept the account name that will be created and click Next. 


23 Accept or modify the NSM Administrators group name, leave the Add current user to NSM 
Administrators Group check box selected, then click Next. 


24 When you are notified that a Proxy Home share will be created on the engine’s local Proxy 
Home source path, click Next. 


The following page appears: 
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26 


27 


28 


O Novella Storage Manager 


The Novell Storage Manager service proxy account needs appropriate 
rights in the tree to manage users’ volumes and directories, as well as 
manipulate certain objects and attributes in eDirectory. You may choose 
to manually grant these rights. For a complete description of these 
rights, see the Novell Storage Manager Administrator's Guide. 


© I will manually assign rights to the service proxy account 


Assign the NSMProxy account Supervisor rights to the root of the directory tree by accepting the 
default option. 


If you choose to set the rights manually, click the corresponding option. 


Accept the name of the NSM Administrators group as NsMAdmins and leave the Add current 
user to the ANM Administrators Group check box selected, then click Next. 


Because this is a new installation and not a migration from an earlier version of Novell Storage 
Manager, click Next. 


You are notified that Novell Storage Manager needs to initialize its engine and susbsystems. 
Click Next. 


The following page appears: 
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O Novello Storage Manager 


Proxy Home Share 


A Share will be created on the engine's local Proxy Home source path 


Woes 1a. drevcorp.com\NSMProxyhome 


29 Accept the default path or indicate a new path for the proxy home share, then click Next. 


The proxy home share is the location that managed items, such as home directories, temporarily 
reference when they are going through a move operation. 


The following page appears: 
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© Novella Storage Manager 


Complete Migration 


Ifyou are completing a migration from Novell Storage Manager, select 
the Complete Migration checkbox, then click Next to continue. 


Ifthis is a new install, simply click Next to continue. 


T Complete Migration 
Migration Staging Área Path: 


C:JUsers| Administrator A4ppDatalRoaming|NovelliStorage Manag Browse 


Back || nee] Cancel | 


30 Click Next. 


You are informed that Novell Storage Manager needs to initialize the NSM Engine and its 
subsystems. 


31 Click Next. 


32 (Conditional) If you want to now run NSMAdmin, enter your password and click Login. 
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Installing Novell Storage Manager 3.1.1 
for eDirectory 


This section provides procedures for installing the NSM Engine, NSMAdmin, the Event Monitor, and 
the NSM Agents. For information on how these components work in a Novell Storage Manager 
deployment, see the Novell Storage Manager 3.1.1 for eDirectory Administration Guide. 


You should follow these procedures only after you have performed the prerequisite tasks in 
Chapter 1, “Prerequisites,” on page 7, and obtained a Novell Storage Manager 3.1.1 for eDirectory 
product license as indicated in Chapter 2, “Licensing the Product,” on page 11. 


This section also provides procedures for assigning rights and privileges to the NSMProxyRights 
group that is created when you install NSMAdmin. 


+ 


+ 


+ 


+ 


+ 


Section 5.1, “Installing the NSM Engine,” on page 53 

Section 5.2, “Configuring the NSM Engine,” on page 54 

Section 5.3, “Installing the Event Monitor,” on page 56 

Section 5.4, “Configuring the Event Monitor,” on page 57 

Section 5.5, “Installing an NSM Agent,” on page 60 

Section 5.6, “Configuring an NSM Agent,” on page 61 

Section 5.7, “Installing and Configuring NSMAdmin,” on page 64 
Section 5.8, “Authorizing the Event Monitor,” on page 71 

Section 5.9, “Authorizing the NSM Agents,” on page 71 


5,1 Installing the NSM Engine 


Novell Storage Manager uses only one NSM Engine per tree. The NSM Engine can be installed on a 
server that meets the following minimum requirements: 


+ Novell Open Enterprise Server 2 SP2a or later with an x64 processor 


+ Novell Open Enterprise Server 11 SP1 with Jan. 2013 Maintenance release or later 


+ eDirectory 8.7.3.9 or later; or eDirectory 8.8 SP 2 or later 


1 At the root of the NSM_3_1_1.iso image, click the install .html file. 
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= Novell. Storage Manager 
— Installation 


** Note: MSI based installers should be downloaded, and then installed 


Configuration Options Components 


Choose a Directory Service Engine 
Microsoft Active Directory SLES 10 

@© Novell eDirectory novell-storagemanager-engine-3.1.1-42.x86_64.rpm 
SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Read the EULA 
Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.1586.rpm 
novell-storagemanager-event-3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


2 Select Novell eDirectory. 


3 Under the platform on which you are installing the NSM Engine, click novell-storage-manager- 
engine-3.1.1-xx.x86_64.rpm. 


4 Save the RPM. 
5 Launch a terminal session. 


6 Install the NSM Engine RPM package by typing: 


# rpm -i novell-storage-manager-engine-3.1.1-xx.x86_64.rpm. 


7 Continue with Section 5.2, “Configuring the NSM Engine,” on page 54. 


5.2 Configuring the NSM Engine 


1 At the same terminal, type nsmengine-config and press Enter. 


The console is updated and looks similar to the one below. 
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Terminal 


Edt View Terminal Tabs Help 


Engine Service Setup Wizard 

Please fill in the following required fields: 
Current Address: 127.0.0.1 

Select new Engine address: 

[0] 172.17.2.15 


Selection-> 


If your server has multiple NIC cards, multiple IP address options are listed. 
2 Specify the IP address of the server hosting the NSM Engine and press Enter. 
If the displayed IP address is correct, you can press 0. 
3 When the HTTP Port [0] option appears, type 0 and press Enter. 


The console is updated and looks similar to the one below: 


Terminal 
File Edit View Terminal Tabs Help 
Engine Service Setup Wizard 
Please fill in the following required fields: 
Current Address: 127.0.0.1 
Select new Engine address: 


[0] 172.17.2.15 


Selection->0 


Engine HTTP Port [0] : 
Engine HTTPS Port [3009] : |] 


4 Unless there is a conflict, accept the default HTTPS port number of 3009 by pressing Enter. If you 
need to use another port number, provide the new port number. 
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5 When you are asked if you want to start the service, click Y for yes. 
This starts the NSM Engine. 
6 Press Enter to continue. 


The console is updated and looks similar to the one below. 


Terminal 


Fie Edit View Terminal Tabs Help 


10.112.20.1 
ss-edir.brett-dev.condreycorp.com 


Engine Settings 1] Default NCP Server Address 


Service Management Certificate Management 
Quit 


At this point, you can navigate through the menu to see how to perform management tasks on 
the NSM Engine when necessary. 


7 Press q to quit. 


5.3 Installing the Event Monitor 


The Event Monitor can be installed on any of the following servers: 


+ Novell Open Enterprise Server 2 SP2a or later with an x86 or x64 processor 
+ SUSE Linux Enterprise Server 10 SP2 or later with an x86 or x64 processor 


+ Novell Open Enterprise Server 11 SP1 with Jan. 2013 Maintenance release or later 
Other notable information about the Event Monitor: 


¢ You can have multiple Event Monitors per directory tree. 


+ Asa best practice, Novell recommends two Event Monitors per replica ring 


+ 


The Event Monitor must be permitted to make outbound connections through the firewall 


1 At the root of the NSM_3_1_1.iso image, click the insta11.html file. 
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= Novell. Storage Manager 


< 


Configuration Options 


Choose a Directory Service 
Microsoft Active Directory 
® Novell eDirectory 


Read the EU 


2 Select Novell eDirectory. 


3 Under the platform on which you are installing the Event Monitor click novell-storage-manager- 


event-3.1.1-xx.xxx.rpm. 
4 Save the RPM. 


5 Launch a terminal session. 


Installation 


** Note: MSI based installers should be downloaded, and then installed 
Components 


Engine 

SLES 10 
novell-storagemanager-engine-3.1.1-42.x86_64.rpm 

SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.1586.rpm 
novell-storagemanager-event-3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


6 Install the Event Monitor RPM package by typing: 


# rpm -i novell-storage-manager-event-3.1.1-xx.xxx.rpm. 


7 Continue with Section 5.4, “Configuring the Event Monitor,” on page 57. 


5.4 Configuring the Event Monitor 


1 At the same terminal, type nsmevent -config and press Enter. 


The console is updated and looks similar to the one below. 
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Terminal 


Edit View Terminal Tabs Help 


Event Service Setup Wizard 

Please fill in the following required fields: 
Current LDAP Address: 127.0.0.1 

Select new LDAP address: 


[0] 172.17.2.15 
[1] Another Server 


Selection-> 


2 Specify the IP address of the server you are going to monitor. 


For example, if you are going to monitor this server, type 0. If you are going to monitor another 
server, type 1 and then type the IP address and other configuration information that is 
requested. 


Event monitors should be configured to monitor at least one server per eDirectory partition ring 
that you care about. That is, you should monitor servers that hold a replica for each eDirectory 
partition that contains objects that you want to receive event data about and for which NSM will 
consequently manage storage. 


3 Press Enter. 


The console is updated and looks similar to the one below. 
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Terminal 


File Edit View Terminal Tabs Help 


Event Service Setup Wizard 

Please fill in the following required fields: 
Current LDAP Address: 127.0.0.1 

Select new LDAP address: 


[0] 172.17.2.15 
[1] Another Server 


Selection->0 

Configure Ports: 

Enter new port values 

For each of the following, enter a port number. 

(Enter zero (0) to turn off a port listener or hit [Enter] to accept 


the current value.) 


LDAP Port [389]: 


4 Accept the default LDAP port setting by pressing Enter. 
5 Accept the TLS-Auth LDAP SSL type by pressing Enter. 
6 Accept the default data path by pressing Enter. 


The console is updated and looks similar to the one below. 


Terminal 


File Edit View Terminal Tabs Help 


Configure Ports: 
Enter new port values 


For each of the following, enter a port number. 
(Enter zero (0) to turn off a port listener or hit [Enter] to accept 
the current value.) 


LDAP Port [389]: 


LDAP SSL Type: 
Clear 

SSL 

TLS-Auth 


Current Data Path: /var/opt/novell/storagemanager/event 
New Path-> 
Engine Address [127.0.0.1] 


7 Specify the IP address of the server hosting the NSM Engine and press Enter. 
You can also enter a DNS entry at this prompt. 
8 Accept the port entry of 3009 by pressing Enter. 
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9 When you are asked if you want to start the service, press y for yes. 
This starts the Event Monitor. 
10 Press Enter to continue. 


The console is updated and looks similar to the one below. 


Terminal 


File Edit View Terminal Tabs Help 


LDAP Address: 172.17.2.15 
LDAP Port: 389 
LDAP SSL Type: TLS-Auth 


Data Path: /var/opt/novell/storagemanager/event 
Heartbeat: 60 seconds 
Engine Address: 172.17.2.15:3009 


LDAP Address LDAP Ports & Settings 
Data Path Debug Options 

Service Management Engine Service 

View Console 2] Quit 


Selection->fj 


At this point, you can navigate through the menu to see how to perform management tasks on 
the Event Monitor when necessary. 


11 Press q to quit. 


5.5 Installing an NSM Agent 


An NSM Agent can be installed on any of the following machines: 


+ Novell Open Enterprise Server 2 SP2a or later with an x86 or x64 processor 


+ Novell Open Enterprise Server 11 SP1 with Jan. 2013 Maintenance release or later 
Other notable information about NSM Agents: 
+ The default NSM Agent port is 3011 


¢ A firewall inbound rule for the NSM Agent is created during the installation 


1 At the root of the NSM_3_1_1.iso image, click the install .html file. 
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= Novell. Storage Manager 
— Installation 


** Note: MSI based installers should be downloaded, and then installed 


Configuration Options Components 


Choose a Directory Service Engine 
Microsoft Active Directory SLES 10 

@© Novell eDirectory novell-storagemanager-engine-3.1.1-42.x86_64.rpm 
SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Read the EULA 
Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.1586.rpm 
novell-storagemanager-event-3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


2 Select Novell eDirectory. 


3 Under the platform on which you are installing the NSM Agent, click novell-storage-manager- 
agent-3.1.1-xX.XXXX.1pM. 


4 Save the RPM. 
5 Launch a terminal session. 


6 Install the NSM Engine RPM package by typing: 


# rpm -i novell-storage-manager-agent-3.1.1-xx.xxxx.rpm. 


7 Continue with Section 5.6, “Configuring an NSM Agent,” on page 61. 


5.6 Configuring an NSM Agent 


1 From the same terminal, type nsmagent -config and press Enter. 


The console is updated and looks similar to the one below. 
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Terminal 


File Edit View Terminal Tabs Help 


Agent Service Setup Wizard 

Please fill in the following required fields: 
Current Host Address: 127.0.0.1 

Select new host address: 

[0] 172.17.2.15 


Select ion->fj 


If your server has multiple NIC cards, multiple IP address options are listed. 
2 Specify the IP address of the server hosting the NSM Agent and press Enter. 
If the displayed IP address is correct, you can press 0. 
3 When the HTTP Port [0] option appears, type 0 and press Enter. 


The console is updated and looks similar to the one below. 


Terminal 
File Edit View Terminal Tabs Help 
Agent Service Setup Wizard 
Please fill in the following required fields: 
Current Host Address: 127.0.0.1 
Select new host address: 
[0] 172.17.2.15 
Selection->0 


Configure Ports: 
Enter new port values 


For each of the following, enter a port number. 
(Enter zero (0) to turn off a port listener or hit [Enter] to accept 
the current value.) 


Agent HTTP Port [0]: 
Agent HTTPS Port [3011]: 


4 Accept the port setting of 3011 by pressing Enter. 
5 Accept the default data path by pressing Enter. 
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6 When you are asked if you want to create the new data path, press y for yes. 


7 When you are prompted for the engine address, specify the IP address for the server hosting the 
NSM Engine. 


8 Accept the 3009 port setting for the NSM Engine by pressing Enter. 


The console is updated and looks similar to the one below. 


Terminal 
Edit View Terminal Tabs Help 
Current Host Address: 127.0.0.1 
Select new host address: 


[0] 172.17.2.15 


Selection->0 
Configure Ports: 
Enter new port values 


For each of the following, enter a port number. 


(Enter zero (0) to turn off a port listener or hit [Enter] to accept 
the current value.) 


Agent HTTP Port [0]: 
Agent HTTPS Port [3011]: 


Current Data Path: /var/opt/novell/storagemanager/agent/data 
New Path-> 


Path does not exist. Create path? [Y/N]: y 
Engine Address [] : 172.17.2.15 

Engine Port [3009] 

Use SSL (Y/N) [Y]: J 


9 When you are asked if you want to use SSL, press y for yes. 
10 When you are asked if you want to start the service, press y for yes. 
This starts the NSM Agent. 
11 Press Enter to continue. 


The console is updated and looks similar to the one below. 
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Fie Edit View Terminal Tabs Help 


Host Address: 10.112.20.1 
Service Ports: HTTPS: 3011 HTTP: 0 


Data Path: /var/opt/novell/storagemanager/agent/data 
Heartbeat: 60 seconds 
Engine Address: 10.112.20.1:3009 

Use SSL: Yes 


Default NCP v e : sawgrass-edir.brett-dev.condreycorp.com 


Agent Address Data Path 

Engine Service N] NCP Server Addres 
Debug Options Agent Ports 
Service Management ) Quit 


Selection->[] 


At this point, you can navigate through the menu to see how to perform management tasks 
when necessary. 


12 Press q to quit. 


5.7 Installing and Configuring NSMAdmin 


NSMAdmin is the administrative interface for Novell Storage Manager. It can be installed on a 
Windows server or workstation that meets the following minimum requirements: 


+ Windows platform (Windows 7, Vista, XP SP3, and Windows Server 2012, 2008, or 2003) 
+ NET 3.5 Framework and .NET 4.0 (Full) Framework installed. 


+ .NET security settings are adjusted if you are running the executable from a network drive 
(optional) 


1 At the root of the NSM_3_1_1.iso image, click the install .html file. 
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= Novell. Storage Manager 


— Installation 


** Note: MSI based installers should be downloaded, and then installed 


Configuration Options Components 


Choose a Directory Service Engine 
D Microsoft Active Directory SLES 10 

@© Novell eDirectory novell-storagemanager-engine-3.1.1-42.x86_64.rpm 
SLES 11 


novell-storagemanager-engine-3.1.1-42.x86_64.rpm 


Read the EULA 
Events 
SLES 10 
novell-storagemanager-event-3.1.1-5.1586.rpm 
novell-storagemanager-event-3.1.1-5.x86_64.rpm 
SLES 11 


novell-storagemanager-event-3.1.1-5.x86_64.rpm 


Agents 
SLES 10 
novell-storagemanager-agent3.1.1-17.1586.rpm 
novell-storagemanager-agent3.1.1-17.x86_64.rpm 
SLES 11 


novell-storagemanager-agent3.1.1-17.x86_64.rpm 


Admin 
NSMAdmin-3.1.1-59025.msi 


2 Select Novell eDirectory. 
3 Click NSMAdmin-3.1.1-xxxx.msi. 


When asked if you want to save or run the file, save the file to the hard drive of a computer 
where you will administer Novell Storage Manager. 


5 From the saved location, launch the NSMA dmin installation file. 


6 When you are asked if you want to run this file, click Run. 


An Introduction page appears in the NSMAdmin Installation Wizard. 


7 Read the text and click Next. 


8 Accept the license terms and click Next. 


9 Accept the installation path or indicate a new path by using the Browse button. 


10 


12 


To review possible locations, you can click Disk Usage to see all available volumes with disk size 
and disk availability data. 


Click Next. 


If you want to create a shortcut on the desktop, leave the Create shortcut on Desktop check box 
selected and click Install. 


NSMA dmin is installed. 
Leave the Launch NSMAdmin 3 check box selected and click Finish. 
NSMAdmin is launched. 
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13 
14 


15 


16 


17 
18 


19 
20 


Novell Storage Manager Admin Client - 3.0.4.4 


© Novella Storage Manager 


Engine 10.112.20.1 Port 3009 
User Name admin.sawgrass 


Password eeeeeee 


K Proxy and Logging Options 


Copyright © 2002-2012 Condrey Corporation. All rights reserved. 4 


In the Engine field, specify the DNS name or IP address. 

In the Port field, specify the secure port number. 

The default setting is 3009. 

Specify the username and password. 

The user must be a member of the NSMAdmins group to be able to log in. 
Click Login. 


If you are unable to log in, your proxy settings might be preventing you from doing so. Until you 
enter a proxy exception in your proxy settings, you can click Proxy and Logging Options, select Do 
not use a Proxy, then click Login. 


The Setup Wizard welcome page appears. 

Read the text on the page and click Next. 

Do one of the following: 
+ Click Browse to locate and select the path to the license file 
+ Click Get a License to obtain an evaluation license 

Click Next. 


The following page appears, asking if you want to extend the Novell eDirectory schema. 


Novell Storage Manager 3.1.1 for eDirectory Installation Guide 


eToz sequiajdas gz (ua) sÁsoop 


Setup 


© Novello Storage Manager 


Novell Storage Manager requires extentions to the eDirectory schema. 


There are no side effects to re-applying the schema extensions to an 
existing installation. 


IMPORTANT: Be sure that time is synchronized to the network on the 
server holding the Master replica of the [ROOT] partition. 


NOTE: If you are applying maintenance to a pre-existing installation, 


you should reapply the schema as there have been updates. Novell 
Storage Manager will not run without these newer updates! 


Extend the schema 


If you plan to manage collaborative storage or auxiliary user storage, you must extend the 
eDirectory schema. 


21 Click Next. 
The following page appears: 
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Novella Storage Manager 


Novell Storage Manager needs to create a service proxy account. By 
default, this account will be created in the same container as the logged 
-in user. If desired, a different container and account name may be 
entered using a fully distinguished name like ProxyUser.OU1.OU.ORG. 


Service Proxy Account ISMProxy.novell 


22 Accept the account name that will be created and click Next. 


23 Accept or modify the NSM Administrators’ Group name, leave the Add current user to NSM 
Administrators Group check box selected, then click Next. 


24 When you are notified that a Proxy Home share will be created on the engine’s local Proxy 
Home source path, click Next. 


The following page appears: 
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26 


27 


28 


O Novella Storage Manager 


The Novell Storage Manager service proxy account needs appropriate 
rights in the tree to manage users’ volumes and directories, as well as 
manipulate certain objects and attributes in eDirectory. You may choose 
to manually grant these rights. For a complete description of these 
rights, see the Novell Storage Manager Administrator's Guide. 


© I will manually assign rights to the service proxy account 


Assign the NSMProxy account Supervisor rights to the root of the directory tree by accepting the 
default option. 


If you choose to set the rights manually, click the corresponding option. 


Accept the name of the NSM Administrators group as NsMAdmins and leave the Add current 
user to the ANM Administrators Group check box selected, then click Next. 


Because this is a new installation and not a migration from an earlier version of Novell Storage 
Manager, click Next. 


You are notified that Novell Storage Manager needs to initialize its engine and susbsystems. 
Click Next. 


The following page appears: 
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O Novello Storage Manager 


Proxy Home Share 


A Share will be created on the engine's local Proxy Home source path 


Woes 1a. drevcorp.com\NSMProxyhome 


29 Accept the default path or indicate a new path for the proxy home share, then click Next. 


The proxy home share is the location that managed items such as home directories temporarily 
reference when they are going through a move operation. 


The following page appears: 
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30 


31 
32 
33 


© Novelle Storage Manager 


Complete Migration 


Ifyou are completing a migration from Novell Storage Manager, select 
the Complete Migration checkbox, then click Next to continue. 


Ifthis is a new install, simply click Next to continue. 


T Complete Migration 
Migration Staging Área Path: 


C:\Users\ Administrator AppData\Roaming\Novell\Storage Manag Browse 


Back [mex] Cancel | 


Because this is a new installation and not a migration from an earlier version of Novell Storage 


Manager, click Next. 


You are informed that Novell Storage Manager needs to initialize the NSM Engine and its 
subsystems. 


Click Next. 
When you are prompted, enter your password and click Login. 


Proceed with Section 5.8, “Authorizing the Event Monitor,” on page 71. 


5.8 Authorizing the Event Monitor 


N Oo oO FB WN F 


In NSMAdmin, click the Configure tab. 

Click Event Servers. 

Select the listed server. 

Click the check mark button. 

When you are asked if you want to authorize the selected event monitor, click Yes. 
When the Results page appears, click Close. 

Proceed with Section 5.9, “Authorizing the NSM Agents,” on page 71. 


5.9 Authorizing the NSM Agents 


1 
2 


In NSMAdmin, click the Configure tab. 
Click Agent Servers. 
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3 Select a listed server. 
4 Click the check mark button. 
5 When you are asked if you want to authorize the selected event monitor, click Yes. 


6 When the Results page appears, click Close. 
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A.1 


A.2 


NSM Engine Certificate 
Management 


The enhanced SSL certificate management capabilities introduced in Novell Storage Manager 3.0.4 
allow you to generate your own certificates. This section provides information for managing these 
certificates. 


+ Section A.1, “Upgrading Earlier Versions of Novell Storage Manager,” on page 73 
+ Section A.2, “Creating a New Certificate,” on page 73 
+ Section A.3, “Managing Existing Certificates,” on page 74 


Upgrading Earlier Versions of Novell Storage Manager 


When you upgrade the NSM Engine from any earlier version to 3.1, a new SSL certificate must be 


generated before the engine can start successfully. If the rensmengined script is invoked to start the 


Engine before a new certificate is created, the script generates a certificate that uses the default 
settings. 


Creating a New Certificate 


You can use the Certificate Management Wizard to create the initial certificate if the Engine has not 


been started since Novell Storage Manager 3.1.1 was installed. You can also create another certificate 


if you need to change the default settings. 


1 Load the NSM Engine Configuration Utility by running nsmengine-config. 
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Terminal 


View Terminal Tabs Help 


Address: 10.10.10.20 
HTTP Port: 0 
HTTPS Port 3009 
Default NCP Server Address: sawgrass-edir.brett-dev.condreycorp.com 


[A] Engine Settings [N] Default NCP Server Address 
[S] Service Management [C] Certificate Management 
[Q] Quit 


Selection->[] 


2 Inthe console, enter C to start the Certificate Management Wizard. 
3 Select the settings you want, then press Enter. 


The Certificate Management Wizard prompts you to generate a new OpenSSL certificate using 
the default server name for the common name of the certificate. You can choose to use a different 
name for the common name of the certificate if you want. 


The Certificate Management Wizard generates a 2048-bit RSA private key and stores it as a .pem 
file in the Engine config directory. The details of the certificate are then displayed in the 
console. 


4 Start the NSM Engine, either through the Service Management submenu or at the console with the 
rensmengined start command. 


A.3 Managing Existing Certificates 


After a certificate has been created, you can use the Certificate Management Wizard to view the 
details of an existing certificate. 


1 Load the NSM Engine Configuration Utility by running nsmengine-config. 
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Terminal 


File Edit View Terminal Tabs Help 


Address: 10.10.10.20 

HTTP Port: 0 

HTTPS Port 3009 
Sawgrass-edir.brett-—dev.condreycorp.com 


[A] Engine Settings [N] Default NCP Server Address 
[S] Service Management [C] Certificate Management 
[Q] Quit 


Selection->[] 


2 Inthe console, enter C to start the Certificate Management Wizard. 


Terminal 


File Edit View Terminal Tabs Help 


[C] Create a new certificate 
[V] View the current certificate 
[Q] Quit 


Selection->(] 


3 Enter Y to view the certificate. 
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B.1 


Deploying Event Monitors and NSM 
Agents Remotely by Using the 
DeployAgents Tool 


¢ Section B.1, “Overview,” on page 77 

¢ Section B.2, “Prerequisites,” on page 78 

+ Section B.3, “Copying the Component Installers,” on page 78 

+ Section B.4, “Creating the servernames.txt File,” on page 79 

+ Section B.5, “Deploying the Linux RPMs,” on page 81 

+ Section B.6, “Deploying the Windows MSI or EXE Files,” on page 82 


Overview 


The DeployAgents tool lets you remotely install Novell File Reporter agent software and Novell 
Storage Manager agent and Event Monitor software through a batch installation process. Installer 
formats vary, based on agent type and environment: 


Table B-1 Installer Formats for Deploy Agents Tool Components 


Component Installer Format 

Storage Manager for the Active Directory Agent MSI 

Storage Manager for the eDirectory Agent RPM 

Storage Manager Event Monitor on Windows MSI 

Storage Manager Event Monitor on Linux RPM 

File Reporter Agent for Windows MSI in boot-strapped EXE 
File Reporter Agent for Linux RPM 


The DeployAgents tool performs the following actions: 


¢ Installs and configures the agent or Event Monitor software 
+ Creates and copies the necessary SSL certificate for each server 
+ Modifies and copies the configuration file (if necessary) 


+ Sets any necessary privileges on the local server 
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NOTE: OpenSSL certificates are generated using the OpenSSL command line utilities, which have 
not been modified, and are distributed with permission. See the attribution provided in the OpenSSL- 
License. txt file for more details. 


B.2 Prerequisites 


+ Section B.2.1, “Windows PowerShell,” on page 78 
+ Section B.2.2, “Windows Agents and Event Monitors,” on page 78 


+ Section B.2.3, “Linux Agents and Event Monitors,” on page 78 


B.2.1 Windows PowerShell 


On the Windows workstation where you are conducting the remote installations, verify that 
Windows PowerShell 2.0 or above is installed. 


B.2.2 Windows Agents and Event Monitors 


+ Verify that Windows PowerShell 2.0 or above is enabled on each Windows server where agents 
or Event Monitors are being installed in an Active Directory environment. 


DeployAgents uses Windows PowerShell version 2.0 or above for parsing text, hiding 
credentials from plain text, and remote installation, but requires that remote signed scripts be 
allowed. 


+ Verify that the ExecutionPolicy is set to something other than RESTRICTED. 
REMOTESIGNED works for deploying MSI files. 


Use the Get -Execut ionPolicy PowerShell command to determine how the current policy is set. 
The Set-ExecutionPolicy RemoteSigned command can be used to change the current policy 
to one that is compatible with this process. 


+ Verify that the .NET 4.0 (Full) Framework is installed and enabled on each Windows server. 


B.2.3 Linux Agents and Event Monitors 


+ Verify that SSH is enabled and the port is set to the default port 22. 


RPM installations require that all Linux servers are installed with default port numbers. 


+ Open Enterprise Server must be installed on the SUSE Linux Enterprise Server before installing 
the agent RPMs. 


B.3 Copying the Component Installers 


1 From the Novell Storage Manager or Novell File Reporter software ISO image, copy the 
DeployAgentv2.xx.zip file to a folder of your choice. 


2 Unzip the file. 
The folder structure looks like the image below: 
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4 | DeployAgents.v2.26 
4 |. DeployEXE 
Ly software 
» utils 
aL DeployMSI 
de software 
do utils 
4 |L DeployRPM 
de software 
Le utils 


3 From the Novell Storage Manager or Novell File Reporter ISO image, copy all of the agent and 
Event Monitor installation files you want to install into the software folder of the appropriate 
installer format. 


For example, if you were going to do a batch installation of 32-bit and 64-bit Windows agents for 
Novell File Reporter, you would copy the following files into the DeployEXE/software folder: 


Windows/x86/NFRAgent -Installer-x86-2.0.xx.exe 


Windows/x86/NFRAgent -Installer-x64-2.0.xx.exe 


Always copy both the 32-bit and 64-bit versions of the installer MSI or EXE to the local software 
folder. The DeployAgents tool determines the architecture of the server and installs the 
appropriate version. 


For Linux agents and Event Monitors, copy the entire sles10 and sles11 folders from the 
Novell Storage Manager or Novell File Reporter ISO images to the sles10 and sles11 folders 
inside the DeployRPM/software folder. The DeployAgents tool determines the proper 
distribution and installs the appropriate component from the appropriate directory. 


4 Verify that each software folder contains a configuration file for the agent or Event Monitor. 


Depending on the type of agent or Event Monitor, this will be a .conf file for Linux ora .cfg 
file for Windows. 


5 In the configuration file, replace the sample IP address with the NFR or NSM Engine address. 
The sample NFR Engine address to be edited looks like this: 


<Engine HostAddress="192.168.17.11" Port="3035" Secure="1" 
PollingIntervalHB="60000" /> 


The sample NSM Engine to be edited looks like this: 
<Engine> 


<HostAddress>10.82.2.16</HostAddress> 


<Engine> 


<HostAddress>192.168.17.11</HostAddress> 


B.4 Creating the servernames.txt File 


+ Section B.4.1, “Manually Creating the servernames.txt File,” on page 80 


+ Section B.4.2, “Automatically Creating the servernames.txt File,” on page 80 
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B.4.1 


B.4.2 


This file specifies the names of all of the servers on which the agent or Event Monitor software is to be 
deployed. The file is specific to each of the installer formats identified in Table B-1 on page 77. For 


example, there should be an individual servernames.txt file for MSI files, EXE files, and RPM files. 


Manually Creating the servernames, txt File 


1 Launch a text editor such as Notepad. 


2 On individual lines, type the names of each server where you want to deploy the agent or Event 
Monitor software. 


Depending on whichever is appropriate for your environment, you can use simple or DNS 
naming. We recommend DNS naming. 


For example: 

cclx1l.cctec.org 
cclx2.cctec.org 
cclx3 .cctec.org 


3 Save the document as servernames .txt to the root directory of the deployment folder for the 
installer format. 


For example, if the servernames.txt file listed Novell Open Enterprise Server machines, you 
would save the file to the DeployRPM folder. 


Automatically Creating the servernames.txt File 


If you already have agents or Event Monitors installed and you want to update them, the 
Deploy Agents tool can automatically create a servernames.txt file for you. 


Simply copy the agents.dat or eventmonitors.dat file from its location on the NSM Engine or 
NFR Engine to the root of DeployEXE, DeployMSI, or DeployRPM folders. 


Table B-2 Locations of agents.dat and eventmonitors.dat Files 


Product Location on Windows Location on Linux 

Storage Manager C:\ProgramData\Novell\Storage Ivar /opt/novell/storagemanager/ 
Manager\Engine\data\agents.dat engine/data/agents.dat 

Storage Manager C:\ProgramData\Novell\Storage /var/opt/novell/storagemanager/ 
Manager\Engine\data\eventmonitors engine/data/eventmonitors.dat 
.dat 

File Reporter c:\ProgramData\Novell\File No agent . dat file with Version 1. 


Reporter\Engine\data\agents.dat 


When you provide either the agents. dat file or the eventmonitors. dat file, the Deploy Agents tool 
parses the existing server names and creates the servernames.txt file for you. 
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B.5 Deploying the Linux RPMs 


+ Section B.5.1, “External Utilities,” on page 81 
+ Section B.5.2, “Deployment Specifics,” on page 81 
+ Section B.5.3, “Using DeployAgentsRPM.cmd,” on page 81 


B.5.1 External Utilities 


Deploying Linux agent RPMs from a Windows workstation requires some extra tools. The 

Deploy Agents tool uses two external utilities from the PuTTY software family: plink.exe and 
pscp.exe (http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html). Both utilities are 
distributed with permission and have not been modified. See (http://the.earth.li/-sgtatham/putty/ 
0.58/htmldoc/AppendixC.htmlflicence) for more details. 


B.5.2 Deployment Specifics 


For RPM deployments, the DeployAgents tool performs the following actions. 


+ Uses the RPM command line argument only as a guide to getting the proper component 
installed. The DeployAgents tool determines Novell Open Enterprise Server version and 
architecture, and installs the proper i586 or x86_64 RPM version from the software/sles10 or 
software/sles11 folder as required by the server. 


¢ Uses PowerShell to hide the password from plain text view, but does not encrypt the password 
in memory. It also uses a User-based environment variable, and cleans up the password as soon 
as it finished. 


+ Uses PowerShell to parse the agent .dat or servernames.txt file. The agent .dat file is XML- 
based, and is converted to a plain text list of servers named servernames .txt. If an existing 
servernames .txt file exists, the parser looks for leading and trailing spaces, and makes a copy 
of the original file in servernames.txt.original. 


+ Uses the /etc/SuSE-release and /etc/novell-release files from the server to get Novell 
Open Enterprise Server and SUSE Linux Enterprise Server version information. 


+ Creates a temporary directory in /tmp/software on the server as a local software repository, 
which is cleaned up at the end of the process. 


+ Uses the component's default installation paths and configuration paths. For example, the 
configuration directory would follow this pattern: /etc/opt/nove11/$(product) / 
${component }/config 


+ Assumes that the root or provided administrative user account shares the same password across 
all servers in the servernames .txt file. 


B.5.3 Using DeployAgentsRPM.cmd 


Usage: 


DeployAgentsRPM.cmd <agents.dat> <linux admin username> <rpm to deploy> 
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B.6 


B.6.1 


B.6.2 


Explanation 


The <agents.dat> is provided by the product whose agent or Event Monitor you are attempting to 
deploy. It can be found in the engine component data directory. Both the NSM Engine and NFR 
Engine provide this file. 


The <linux admin usernames, generally root, is needed to install software. 


The <rpm to deploys is just the RPM name without path information. 


Example on a Single Command Line 


DeployAgentsRPM.cmd agents.dat root novell-filereporter-agent-2.0.0-4.1586.rpm 
Or 


DeployAgentsRPM.cmd servernames.txt root novell-filereporter-agent-2.0.0- 
4.1586.rpm 


Deploying the Windows MSI or EXE Files 


+ Section B.6.1, “Deployment Specifics,” on page 82 

+ Section B.6.2, “Setting an Alternate Installation Path,” on page 82 
+ Section B.6.3, “Using DeployAgentsMSI.cmd,” on page 83 

+ Section B.6.4, “Using DeployAgentsEXE.cmd,” on page 83 


Deployment Specifics 
For MSI and EXE deployments, the Deploy Agents tool performs the following actions: 
+ Employs wrapper scripts that work with both the Novell Storage Manager MSI agents and 


Event Monitors and the Novell File Reporter EXE agents. 


¢ Utilizes scripts that rely on the C$ admin share being available on the servers where the agent is 
to be installed, and that the c:\temp directory exists or can be created, and can be written to 
over the network by a domain administrator. 


+ Uses the installer name without path information. 


¢ Uses the latest version by time and date in the software folder, regardless of the command line 
designation. 


Setting an Alternate Installation Path 


By default, Deploy Agents installs the agent and Event Monitor software to the following locations: 


Table B-3 Default Installation Paths 


Software File Path 
NSM Agent C:\Program Files\Novell\Storage Manager Agent 
NSM Event Monitor C:\Program Files\Novell\Storage Manager\Event 
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Software File Path 


NFR Agent C:\Program Files\Novell\File Reporter\Agent 


For MSI and EXE files, you can change the default installation path for the agent or Event Monitor 
software through the AlternateInstallPath.txt file. 
1 In the root of the DeployEXE or DeployMST file, locate the AlternateInstallPath.txt file. 
2 Rename the file to AlternateInstallPath.txt by removing the underscore. 
After it is renamed, the file can be edited via Notepad or another text editor. 


The AlternateInstallPath.txt file uses a combination of text and variables so it can be used 
over and over. 


3 Use Notepad or another text editor to edit the installation path. 


You can change the drive letter, add additional path text, or change the text altogether to make 
the component best fit your environment. 


MSI Example: 
Default path: c:\sbrand%\%product%\%component% 
Modified path example: e:\sbrand%\%product%\%component% 
EXE Example: 
Default path: c:\%brand%\%product%\ 
Modified path example: e:\%brand% \ %product% \ 
4 Save the AlternateInstallPath.txt file. 


B.6.3 Using DeployAgentsMSI.cmd 


1 Launch the DOS Command Prompt utility. 
2 Change to the DeployMSI directory. 
3 Do one of the following: 


+ Enter: deployAgentsMSI.exe servernames.txt domain\administrator NSMAgent - 
3.1.0-x64-xx.msi 


+ Enter: deployAgentsMSI.exe agents.dat domain\administrator NSMAgent-3.1.0- 
x64-xx.msi 


When you deploy MSIs through an agents. dat file, if a servernames.txt file already 
exists, you are asked if you want to use the servernames .txt file that already exists. 


If you choose No, the servernames.txt file is deleted and a new one is created, based on 
the contents of the agent . dat file. 


B.6.4 Using DeployAgentsEXE.cmd 


1 Launch the DOS Command Prompt utility. 
2 Change to the DeployEXE directory. 
3 Do one of the following: 


+ Enter: deployAgentsEXE.exe servernames.txt domain\administrator NSMAgent - 
3.1.0-x64-xx.exe 
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+ Enter: deployAgentsEXE.exe agents.dat domain\administrator NSMAgent-3.1.0- 
x64-xx.exe 


When you deploy EXEs through an agents. dat file, if a servernames.txt file already 
exists, you are asked if you want to use the servernames .txt file that already exists. 


If you choose No, the servernames .txt file is deleted and a new one is created, based on 
the contents of the agent . dat file. 
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C.1 


C.2 


C.3 


Documentation Updates 


This section contains information about documentation content changes that were made in this 
Novell Storage Manager 3.1.1 for eDirectory Installation Guide after the initial release of Novell Storage 


Manager 3.0 for eDirectory. The changes are listed according to the date they were published. 


The documentation for this product is provided on the Web in two formats: HTML and PDF. The 
HTML and PDF documentation are both kept up-to-date with the changes listed in this section. 


If you need to know whether a copy of the PDF documentation that you are using is the most recent, 
the PDF document includes a publication date on the title page. 


The documentation was updated on the following dates: 


October 17, 2013 


Updates were made to the following sections: 


Location 


Section 3.14, “Configuring the Event Monitor,” on 
page 33. 


Section 5.4, “Configuring the Event Monitor,” on 
page 57. 


June 12, 2013 


Updates were made to the following sections: 


Location 


Chapter 4, “Upgrading from Storage Manager 3.x to 
3.1.1,” on page 41. 


Section B.2.1, “Windows PowerShell,” on page 78. 


February 13, 2013 


Updates were made to the following sections: 


Update Description 


Corrected the syntax in Step 2. 


Corrected the syntax in Step 1. 


Update Description 


New chapter. 


New section. 
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C.4 


C.5 


Location 
Chapter 3, “Upgrading from Storage Manager 2.5x to 
3.11,” on page 15. 


Chapter 5, “Installing Novell Storage Manager 3.1.1 for 
eDirectory,” on page 53. 


Section 3.4, “Installing NSMAdmin 3.1.1,” on page 19. 


Section 3.8, “Upgrading the NSM Engine,” on page 24. 


Section 5.2, “Configuring the NSM Engine,” on 
page 54. 


Section 5.7, “Installing and Configuring NSMAdmin,” 
on page 64. 


January 18, 2013 


Updates were made to the following sections: 


Location 


Multiple locations throughout the manual. 


Section 1.2, “Determining Your Installation Method,” 
on page 7. 


Appendix B, “Deploying Event Monitors and NSM 
Agents Remotely by Using the DeployAgents Tool,” on 
page 77. 


May 18, 2012 


Updates were made to the following sections: 


Location 


Section 3.9, “Configuring the NSM Engine,” on 
page 25. 


Appendix A, “NSM Engine Certificate Management,” 
on page 73. 


Update Description 


Updated the chapter to include NSM Engine, Event 
Monitor, and NSM Agent support for Open Enterprise 
Server 11 and Open Enterprise Server 11 SP1. 


Updated the chapter to include NSM Engine, Event 
Monitor, and NSM Agent support for Open Enterprise 
Server 11 and Open Enterprise Server 11 SP1. 


Updated the requirements to include the .NET 4.0 
(Full) Framework. 


Updated the supported servers to include Windows 
Server 2012. 


Removed support for a server host with an x86 
processor. 


Removed support for a server host with an x86 
processor. 


Updated the requirements to include the .NET 4.0 
(Full) Framework. 


Updated the supported servers to include Windows 
Server 2012. 


Update Description 


Changed references of 3.0.x to 3.1. 


Modified this section based on removal of software 
repository installation option. 


new appendix. 


Update Description 


Modified the procedures beginning with Step 7 on 
page 26. 


New appendix. 
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C.6 


C.7 


February 2, 2012 


Updates were made to the following section: 


Location 


Throughout the manual. 


February 14, 2011 


Updates were made to the following section: 


Location 


Section 2.1, “Licensing Overview,” on page 11 


Update Description 


Changed 3.0.2 to 3.0.x. 


Update Description 


Overview of license types and the features and 
capabilities enabled in each. 
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